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^"Without a doubt, the Premiere Resource Editor 
for the Mac OS ... A wealth of time-saving tools.^^ 

— MacUser Magazine Eddy Awards 

M distinct improvement over Apple's ResEdit, 

— MacTech Magazine 

'Every Mac OS developer should own a copy of Resorcerer/' 

— Leonard Rosenthof Aladdin Systems 

'‘Without Resorcerer, our localization efforts would look like a ^ 

Tower of Babel. Don’t do product without it!” 

“ Greg Galanos, CEO and President, Metrowerks 

'Resorcerer's data template system is amazing.” 

- Bill Goodman, author of Smaller Installer and Compact Pro 

‘Resorcerer Rocks! Buy it, you will NOT regret it” 

- Joe Zobkiw, author of A Fragment of Your Imagination 

“Resorcerer will pay for itself many times over in saved time and effort” 
“ MacUser review 

“The template that disassembles PICT’s is awesome!” A 

- Bill Steinberg, author ofPyro! and PBTools 

“Resorcerer proved indispensibie in its own creation!” 

- Doug McKenna, author of Resorcerer 
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• MacOS 8 Appearance Manager-savvy Control Editor 

■ PowerPlant text traits and menu command support 

• Complete AIFF sound fUe disassembly template 

■ Big-, little-, and even mixed-endian template parsing 

• Auto-backup during file saves; folder attribute editing 

• Ships with PowerPC native, fat, and 68K versions 
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Fully supported; it's easier, faster, and more productive than ResEdit 
Safer memory-based, not disk-file-bascd, design and operation 
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Visible, accumulating, editable scrap 

Searches and opens/marks/selects resources by text content 
Makes global resource ID or type changes easily and safely 
Builds resource files from simple Rez-like scripts 
Most editors DeRez directly to the clipboard 

All graphic editors support screen-copying or partial screen-copying 
Hot-linking Value Converter for editing 32 bits in a dozen formats 
Its own 32-hit List Mgr can open and edit very large data structures 
Templates can pre- and post-process any arbitrary data structure 
Includes nearly 200 templates for common system resources 
TMPLs for Installer, MacApp, QT, Balloons, AppleEvent, GX, etc. 

Full integrated support for editing color dialogs and menus 
Try out balloons, Tetb's, lists and popups, even create C source code 
Integrated single-window Hex/Code Editor, with patching, searching 
Editors for cursors, versions, pictures, bundles, and lots more 
Relied on by thousands of Macintosh developers around the world 


Includes: Electronic documentation 
60-day Money-Back Guarantee 
Domestic standard shipping 


Payment: Check, PO s, or Visa/MC 
Taxes: Colorado customers only 


Extras (call, fax, or email us): 
COD, FedEx, UPS Blue/Red, 
International Shipping 
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PO Box 298 

Boulder, CO 80306-0298 USA 
Phone: (303) 440-0707 
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resorcerer® m athemaes the tics. com 


To order by credit card, or to get the latest news, bug fixes, updates, and apprentices, visit our websitc„. 
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by Eric Gundnim 


WWDC IS Just Around the Corner 

The week beginning May 11, thousands of developers from 
around die world will gather in San Jose, California for Apple's 
annual World Wide Developer Conference (WWDC). My friends 
at Apple tell me that this will be a veiy exciting conference with 
much new information for developers. 

For me, one of the best features of Vt'^WDC is how it revitalizes 
my enthusiasm for Macintosh development. Most develoj^ers Tve 
talked with come away frcjin die conference very excited about 
trying the new’ technologies, as w^ell as working w'idi die old. 
Meeting wath tlmusands of like-minded people helps me reaffiim 
niy faith in the technology, if not in Apple. Widi Steve Jobs at the 
helm, 1 expect this year’s conference to be even more invigcjraring 
than usLiah After all, Steve always puts on a great show, 

In recent years, many developers have complained that WWDC 
has lieen full of too much marketing and not enough nitty, gritty 
technical content as in the old days; tiie techniatl value to developers 
had diminis] led in reeeni yens. One pixSsSible explanation Ibr the lack 
of icx:linical detail is that Apple’s marketing depaitmeni had ultimate 
contiol t)vcT what sessions occuncxl and how tlie material was 
presented; ADR (inciuding Evangelism and DTS) piovided guidance, 
but wiien push came to shove, the developers lost to the people 
who think tlieir audience wall gel lx>aid reading stTeen after .screen 
of "gibberish" in a mono-spaced font. 

My friends in ADE tell me that they have lieard tliis me.ssage 
from developers: not only do we w'ani to see whil cool 
technologies Apfile has for us, but wc want to see how to use 
them. Wc vvant ent >ugh leclinical details to see what code wc have 
to write. We want to see die AI^ls piesented in the context of real, 
prodLictive ctxle. We want enougli detail that we can go home and 
program our Macs without having to read the manuals, just as our 
users don’t read manuals to use our proclucLs. (I don’t mean to stiy 
we don’t read nianuaLs, but we don't, do w^e? At [east not until w e 
gel into IrtHible.) I ftipefully, Apple will deliver and we will have 
tine best, most useful W^T)C in many years. 

The topics for .should be very^ interesting. Apple's 

planning for WX5(1)C has lieen going on around (lie same rime 
[hey have been deciding the company's future direction, 
including w^hat features wall be in the next Mac OS release, wliat 
w ill Ix.^ in the OS for Apple's Neiw'ork Comj:)Uter, what w ill be the 
future of the Newton hardware, and more. At Seyliokf Apple 
made a big deal about WebObjeets. ColorSync, AppleScript, and 
QuickTime. I’m sure tiiey will give us more technical details at 
’'JtAITlC. With Apple finally making a .serious cxaiimitment to 
Cf>k>rSync, every developer whose products shares color 
information (as in graphics) vwith other products should be using 
ColorSync, Apple's official recommitment to AppleScript raises the 
importance of developers making their applications scriptable. 
(See the MacTech Scripring issue in Februaty^ 1998.) 


QuickTime 3 0 has been a hot topic among developers for 
many months. One of the most significant new^ features of QT 
3.0 is that the Windows version finally offers the same features 
as the Macintosh version. To make this work, the QuickTime 
team itnplemented significant features of the Macintosh Toolb{.)x 
on Windowes and exposed them through the QuickTime API. 
This can make porting Macintosh applications to Window^s 
much easier; a significant help to Macintosh developers trying to 
meet ilieir customers' demands for cross platform solutions. 

Most important to many of us will be the infonnation about 
Allegro, Apple's next version of the Mac OS. 1 am anxious for 
several new' teclinologies in Allegro, including custom Tliemes 
and Navigatiem Seivices. WW1)C will be the fast public fermni in 
which Apple demcjnstrate.s many of these technologies. 
Develt>pers wall already be seeded w ith Allegro, so we will not 
have to w^ait a year or tw^j as we did with technologies presented 
at previous WWDCs. I think Apple has finally realized how 
frustrated deve]o|>ers have become with Apple's past promises of 
cool teclinologies that never make it out the door. 

By the lime your read this, Apple shoLild be making the 
WWDC schedule available through <http;//devworld,applexom/>. 

I lopefully^ they also w ill webcast much of the conference, so 
developers w'ho cannot attend in person can .still learn from it. Fin 
sure those who do attend will be talking aboui it online shortly 
afterwards, sharing fheir impressions and wha! fhey learn. (Last 
year, John Norstad wrote an excellent repoii of the conference 
and posted it on his w'eb site <hnp://charlotte.at,nwu.edu/j!n/>. Maybe 
lie will do so again this year.) 

Apple’s Java Getting Richer 

A few' montlis ago, Apple released MRJ 2.0, moving tlie Mac 
java runtime engine up to JDK 1,1.3 compalihilily. In thLs issue, we 
have sevemi articles that take advantage of Apple's new MRJ, 
including a cfjmparison of Macintosh Java IDEs, and one tliat offers 
useful inftjrmation abnul coding for multiple platfonns. 

Java is a good object-oriented language. 1 often tell people 
interested in learning to program the Mac that they should start 
w'ith Java. I encourage all of you to spend a little time exploring 
it’s capabilities. Keep in mind that It is still a work in progress. 
Many of the support libraries, such as the grapliical interface 
ciassc.s, sdli do not deliver on the [>romise of “WTite once, run 
eveiywhere.” However, they are better tlian they were a year 
ago. Willi such a strong link between Java and the Web, the 
number of work (opportunities for Java programmers continues 
to increase, especially lor ‘‘serveletsj Java-based server plugins. 
As other Java platforms become available, (opportiinitie,s for Java 
programmers w ill inci ease even more. Exploring Java is not only 
fun, but it is wtorth the time, Ei 
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GETTIlUG 

STARTED 


hy Dave Mark 


Handling Modeless Dialogs 


Looking deeper into the Dialog Manager 


Over tile last few columns, weVe explored tlie mysteries of the 
Dialog Manager via a program c'iilled Dialogger. As promised, the 
next few^ columns will go deeper into the Dialog Manager, 
presenting a program called Modeless. Modeless implemenLs a 
modeless dialog, a dialcig that looks and acts like a regular window, 
but retains the benefits of being maoiiged by the Dialog Manager, 

Modele.ss dialogs require a change in the usual modal 
programming strategy. Modal dialog handling code is usually 
pretty self-contained. Modeless code tends to be larger and more 
spread out, as you1l see when we get to the code. 

Creating tiie Modeless Resources 

Mosi of the resources well need for this monilVs ctilumn 
can be copied from last month’s resource file, Dialogger,rsrc, 
Start by creating a new folder in your Development folder 
named Modeless, Next, duplicate the file Dialogger.rsrc and 
drag the copy into the Modeless fE)lder, Change the name of this 
file to Model ess. rsrc. 

Next, launch ResEdit hy double-clicking the file 
Mode less. rsrc. The Mode less, rsrc window should look similar to 
the one shown in Figure 1, 



Your first mission is to edit the ALRT, replacing any 
references to Dialogger with the appropriate reference to 
Modeless. Double-click on the ALRT icon. When die AlilT-picker 
window appears, double-click the only ALRT listed, the one widi 
a resource JD of 129. When die ALRT editor appears, double¬ 
click the ALRT window so the Dill editor appears. Finally, 
double-click the static text item and, when the static text editor 
appears^ make your changes. Mine are shown in Figure 2. 



Figure 2. A neu^ version oj the About... ALRT. 

When youle happy with your About message, close all 
the windows until you are back at the main window^ Next, 
youll change the About Dialogger item in the Apple menu to 
read About Modeless. 

Double-click the MENU icon to bring up the MENU picker 
window. Next, double-click the Apple MENU, bringing up the 
MENLl editing window'. Click die About Dialogge. item and 
change it so it says About Modeless^ as shown in Figure 3. 



Figure 3* A neiv version of the MENU resource. 
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The Ultimate FileMaker Pro 
Web Development Tool 


Why do scores of high-profile websites rely on Lasso? Why is a portion of Lasso technology 
embedded in FileMaker Pro 4.0’s Web Companion? With a feature set described as incredible, 
find out for yourself why Lasso 2.5 is the sharpest tool for creating online stores, discussion 
groups, response forms and countless other robust dynamic Web applications. 

Over 50 new tags including math, string and variable allow unparalleled data handling 
capability. Combined with an SSL server. Lasso allows for secure data transactions. Create 
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dynamic Web database publishing. To order or for a reseller near you, please call 
425.646.0288. Download your free test drive version today at 
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Close the Apple MENU editing window, then double-click 
the File menu, bringing up the File MNU editing window. Click 
the Settings item and then click in the Cmd-key^ field. Type the 
letter S in the Cmd^key: field. This ties the command-key 
equivalent S to the Settings item in the File menu. My File MENU 
editing window is shown in Figure 4. 



Once you are done, close all the windows leaving just tlie 
main window open. Our final chore is to edit the DLOG and 
DITL re^soLirces that made up Dialogger’s mocktl dialog, changing 
them to refleci the look of a modeless dialog. 

Double-dick the DLOG icon to bring up the DLOG^picker 
window. Next, double-dick die only DLOG listed, the one widi 
the resource id of 128. Tlie Settings DLOG editing window 
should appear. First, click the Initially visible check box, making 
sure it is tuichecked. 

Next, click the second window icon from the left, at the 
top of the editing window. The DLOG window should change 
to reflect your new selection. Modeless dialogs don’t liave the 
traditional double-border of their modal cousins. Instead, they 
look like regular windows, tn this case, we want to give our 
dialog windc}w a close liox, so make sure the Close box check 
box is checked. 

We also want to give our dialog window a title Select Set 
DLOG‘ Characteristics from the DLOG menu. When the 'DLOG' 
Characteristics dialog appears, type the text Fred Settings in the 
Window title: field and click OK. Your new title should be 
reflected in the DLOG editing winck)w. Figure 5 shows my 
DLOG editing window at this point in the prcx-'ess. 



Figure 5- The DLOG editing mndotu, at the half-way point. 


Next, we‘ll edit tlie DITL associated with this DLOG. Double 
dick die DLOG window (within the editing window) so the DITL 
editing window appears. You are now going to delete all the 
items in the DITL except the Pick one: static text item and the 
three radio buttons. 

Click the OK button and press the delete key. Click the 
Cancel button and press the delete key. Click die Show preview 
check box and press the delete key. Finally, dick the user item 
(the grey rectangle) and press delete. 

Next, you'll change the positioning of the remaining four 
items. Double-click the Pick one: static text item and change its 
coordinates to the ones shown in Figure 6. Close the window 
when you are done. 



Figure d New coordinates for the Pick one: static text Uent. 


Double-dick the Afghan radio button and change its 
coordinates to the ones shown in Figure 7, Close the window 
when you are done. 



Dotible-dick the Elephant radio button and change its 
coordinates to the ones shown in Figure 8. Close the window 
when you are done. 



Figure 8, New coordinates for the Elephant radio button. 
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"The MUST attend 
conference if you are 
serious about Mac 
programming.mmor 
to be!" 



With support from Apple® and MacTech® 
Magazine, MacHack is 'THE" conference on 
Macintosh programming and development, MacHack 
gives you the opportunity to meet and talk to Apple 
engineers who actually work on the technologies 
you will be using tomorrow. Network with Macintosh 
developers from hundreds of companies and discuss 
programming techniques and issues you are 
concerned about. Unlike conferences where you are 
being talked "at", at MacHack you will be conversing 
with other programmers about real topics that affect 
you on a daily basis. This conference, by definition, 
is technical! 



MacHack 1998 
The 1 3th Annual Conference 
for Leading Edge Developers 
June 18-21, 1998 
Dearborn, Michigan 
Keynote Speaker: 

Chris Espinosa, "Apple Employee #8" 


You are guaranteed exposure to some of the most 
technically advanced people in the industry. The 
conference is kept to a small size to encourage 
interaction. Events are created to foster relationship 
building, sharpen your coding skills, and educate 
you on a variety of topics - no matter what your skill 
level. In short, you'll mingle, network and learn at 
MacHack 1998! 

But that's not all. Developers at MacHack are at the 
bleeding edge of new and emerging technologies. 
Developers for Rhapsody, Java, Pilot, BeOS and 
WinCE wander around, just waiting to share their 
knowledge with all who are willing to ask. 

Registration Fees until April 15, 1998: 

Attendee: $425 Speaker: $325 

After April 15fh: 

j Attendee: $525 Speaker: $420 

! If you would like to be a speaker, please contact 
j Expotech at the address below. 

I For more informotion or to register 
I contact Expotech at: 

1 264 Bedford Rd, 

Grosse Pointe Park, Ml 48230-1116 
iPhone: 313-882-1824 
FAX: 313-882-6942 
E-MAIL: expotech@ao!. com 
WEB: www.machack.com 


Macintosh is a trodemark of Apple Computor. All others to ihfir respective holders. MacHack ond the MocHock logo are trademarks of Expotech, be. Not affiliated with the MadToxfTM) Group. 









Double-click the Squirrel radio button and change its 
coordinates to the ones shown in Figure 9- Close the window 
when you are done. 



Now we're almost done. Close the DITL editing window, 
leaving you back in the DLOG editing window. The last thing left 
to do is to resize the DLOG to reflect its slimmed down and 
rearranged DITL. Change the Bottom: to 123 and the Right: to 
234 . The final version of our DLOG is shown in Figure 10. 


Select New from the Fite menu to create a new window. Save 
it with the name Dialogger.c in your Modeless folder Select Add 
Window from the Project menu to add Dialogger.c to the project. 
Your project window .should look st^mething like Figure 11. 
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Figure 10. The final version of ottr DLOG. 


Quit ResEdit, being sure to save your changes. Now we're 
ready to enter our source code. 


Rather than print the code here twice, we’ll go straight to the 
waik"through. You can type in the code as we discuss it l>elow 
and you will end up with the complete program, or you can save 
your fmgers some effort and get the complete project from 
MacTech's ftp site <ftp://ftp.maaech,com/s rc/>. 

Walking Through the Source Code 

Much of the Modeless source code will look familiar to you 
from earlier programs. As usual, Modeless starts off #inciuding 
necessary header files, then it begins a .series of #deftnes. The first 
three define the base resource ID, and the resource IDs for the 
ALRT and DLOG resources. 

//include (Controls.b> 

//include (Dialogs*h> 

//include (Menus.h> 

//inc lud e (Quickdraw, h) 

//include <SotLad.h> 

//define kBaseReslD 128 

#deflne kAboutALRTid 129 

^define kDialogResID 128 


Creating the Modeless Project 

Launch CodeWarrior and create a new project based on the 
MacOS:C/C++:Basic Toollx)x 68k stationary. Turn off the Create 
Folder check box. Name the project Modeless.mcp and place it in 
your Modeless folder. Remove SillyBalls.c and Silly Balls, rsrc frc^m 
the project; we will not be using these files. From the Finder, 
drag and drop your Mode less, rsrc file into the project window. 
You also can remove the ANSI Libraries group from the project, 
because we won’t need them, either. 


Want to share a URL with the community? 

Send it in to 

<maOto:urls@mactech.com> 


kVisibte, kMoveToBack, kMoveToFront, and kNoGoAway are 
used in the calls to NewWindow(} and GetNewDlalogO. kSleep, as 
usual, is passed to WajtNextEvent(). 


//define kVisible 
//define kMoveToBack 
//define kMoveToFront 
//define kMoGoAway 
//define kSleep 


true 

MULL 

(WindowPtr)'IL 

false 

7L 


kOn and kOff are passed to SetControlValue() to turn a radio 
button on and off 

//define kOn I 

//define kOff 0 
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Access, of course, is everything. And if you’re looking to AOLto provide it, you're 
*?[# out of luck. With Earthlink, you'll find that we're up 99.9% of the time. You 
won*t be burdened with the annoying busy signals and disconnects AOL is famous 
for (nor their high prices: we Ye still $19.95 a month). And because we have more 
local access numbers than any other Internet Service Provider, you can also get on 
the Net more easily. Speaking of easily, thafs how you can get in touch with us. Our 
_. phone number is cleverly listed below. Talk to you soon. 


PC MA6A2rNE ISP RATINGS ^ 9?) 


Evthllik 

AOL 

Call Ra[» :Wc£>§s 

tkioii 

Poor 

Awcage ihnjgtipul 
(tJQWnlpad SpEMi) 

Excellent 

Poor 

Web thrau^put Success 

ExcellenT 

Good 

Overall Perfonnince 

GcMd 

Poor 


(888)QUIT-AOL, ext. 3926 ~) 

Earthlink still $19.95 


PER MONTH 

©15^98 ErirthLinl« Network, fnc, Att rights reserved. Tradeimarlss are property of their respective owners. 


Vi/ 


EarthLink Network 

'^n<^ 

It's your Internet.^ 


www,earthlink,net 
















These three #defines define the item !Ds for the three radio 
buttons that appear In the modeless dialog, 

^define lAfghan 1 

^define lElephant 1 

IMefine iSquirrel 3 


kLeftMargin and KTopMargin determine the position of the My 
Pet Fred window on the screen. 

{ define kLeftMargin 5 

define kTopMargln 40 

KFirstRadio defines the ID of the first radio button in the 
modeless dialog, kLastRadio defines the ID of the last radio 
button in the set. 

#deflne kFlrstRadio 1 

fMefine kLastRadio 3 


The remainder of the #defines represent the Modeless menus 
and menu items. 


^define mApple kBaseResID 

l^define iAbout 1 


#define mFlle 
^define iSettinge 
fMefine iQuit 


kBasekefiltH'l 

1 

3 


Modeless makes use of four global variables. gDone Is set to 
true until the program is ready to exit. gCurrentPICT contains the 
ID of the current My Pet Fred PICT, gSettingsDLOG is a pointer to 
the modeless dialog. We made this a global so we could keep the 
modeless dialog settings arcmnd, even if we close the dialog. 
gFredWindow points to the My Pet Fred window. Well take 
advantage of this pointer when we delete the My Pet Fred 
window and CTeate a new one. 

Boolean gDone; 

short gCurrentPICT = kBaseResID; 

DialogPtr gSettingfiDLOG = NULL: 

WindowPtr gFredWindow ^ NOLL: 

As always, we created a function prototype for each of the 
Modeless functions, 

void ToolBoxInit{ void ) : 

PloHandle LoadPICT{ short picID ); 

void CreateWindow( void ): 

void MenuBarlnitC void ) : 

void EventLoop( void ); 

void DoEventt EventKecord 'eventPtr ): 

void DoDialogEvent( EventRecord ^eventPtr ): 

void HandleMouaoDownf EventRecord *eventPtr ): 

void HandleMenuCholcet long raenuCboice ); 

void HandleAppleChoice( short item ): 

void HandleFileCholco( short itsni ): 

void DoUpdateC EventRecord •eventFtt ): 

void CreateDialog( void ): 

void FlipControlI ControlHandle control }: 

void SwitchFlCT( void ): 


main() starts off by initialiiing the Toolbox, Next, the menu 
bar is set op and the My Pet Fred window is created, Fmaliy, we 
begin the main event loop. 


/********** fnsin ****"*****^ 
void main ( void ) 

I 

ToolBoxInitO r 
MenuBarInitO ; 

CreateWladowO : 

EventloopO : 

I 

Nothing new about ToolBoxlnit(). 

ToolBoxlnit 

void Toolfloxlnlt ( void } 

t 

InltGrafC &qd,theFort ); 
InitFootsO : 

InitWindows(): 

InltMenusO ; 

TEInitDj 

InltDialogsC NULL ); 

InltCuraor[); 

1 


Just like its Dialogger counterpart, LoadPICT() takes a 
resource ID as an input parameter, loads the specified PICT 
resource, then returns a handle to the PICT. 

/••«*«*** LoadPICT 

PicHandle LoadPICT( short picID ) 

I 

PicHandle pic; 

pic “ GetPicturE{ ploID ): 

If the PICT could not he loaded for some reason, the 
program beeps once, then exits. 

if C pic = NULL ) 
f 

SysBeept 10 ): /* Couldn't load the PICT rcsournd!! 7 
ExitToShellC): 

return( pic ): 


CreateWindowO creates a new My Pet Fred window. 

CreateWindow *****”*»/ 

void GreateWindowt void J 

I 

FicHandle pic: 

Rect r: 


Fir.st, LoadPICTO is called to load the PICT specified by 
gCurrentPICT. 

pic = LoadPICT( gCurrentPICT ); 

Next, the PlCT's bounding rectangle is stored in the local 
variable r. 

r ^ (•*pic).picFrame: 
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Think better. Think quick. Thiinkweb. 
Think fast. Think success. 


Apple Worldwide Developers Conference 
May 11-15, 1998 
San Jose Convention Center 
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OffsetRectO is cMed to normalize the Reel, keeping It the same 
size as the PICT, but moving iis upper left comer to the position 
specified by kleftVIargin and kTopMargin. Basically, weTe setting up 
the bounding rectangle for the new My Pet Fred window* 

OffsetRect( Sir, kLeftMargin - t.left, 
kTopMargin - r.top ): 

This recurngle is passed to N0wWindow(). The new window is 
made visible. Notice that kMoveToBack is passed instead of our 
normal kMoveToFront. Why? We want the window to appear l^ehind 
the modeless dialog window, if the dialog is cunendy visible. 

gFredWindov = NewWindow( KULL, ficr, ‘'\pMy Pet Fred", 

kVisible, noGrowDocProc, kMoYeToBackt kNoGoAvay. OL 

If the window couldn’t be created for some reason, beep 
once, then exit, 

if ( gFredWlndow = NULL ) 
i 

SysEeept LO ); /* Coutdo t Imd ibe WIND resource!!I 7 
ExitTaShellOi 

I 

Finally, make the window visible (this line is unnecessary 
because we created the window w'ith kVisible, but it’s a good 
habit to get into) and make it the current port. We’ll draw die 
current Fred by responding to an update event. 

ShowWindow( gFredWindov ); 

SetPort{ gFredWlndow )♦ 

I 

MenuBarInitO loads the MBAR resource, and makes it the 
current menu bar. 

/*-******** Mc-nuHarlnli **********/ 

void MenuBarluit ( void ) 

[ 

Hand1e menuEa r; 

MenuHandie menu: 

menuBar “ GetMewMBar( klaaeResID ); 

SetMeniiBar ( menuBar ); 

Next, a handle to the Apple menu is retrieved and die desk 
accessories added to the menu. 

menu =" GetMeuuHaudlc ( mApple ): 

AppendReMenu( menu, 'DRVR' J ; 

Finally, the menu bar is redrawn* 

DrawMenuBarO : 

1 

EventLoopO looks much die same. As you’d expect, the 
program exits when gDone is set to trtie. 

/***•**’'** EveQtUxjp 

void EventLoop ( void } 

i 

EventRecord event: 


gDone = false: 

while C gDone “ false ) 

t 

if { WaitNextEventt everyEvent* Seventy kSleep, NULL ) ) 
DciEvent{ feevent ) : 

J 


DoEventO is slightly different than previous incarnations. 

/ . DoEvent 

voidDoEvent( KveTitRecord *eveiitPti: ) 

I 

char theChar: 

The first difference lies in our call of lsDtalogEvent{). 
IsDialogEventO takes a pointer to an EventRecord as a parameter 
and returns tme if the event is associated with a modeless dialog. 
Note that our code calls lsDialogEvent() whether or not a 
modeless dialog is currently open. Since we aren’t that 
concerned with efficiency here, this is just fine. In a more 
complex program, you might want to check to see if any of your 
modeless dialogs are open before you call IsDialogEventO. 
Obviously, if your program contains no modeless dialogs, you 
shouldn’t call IsDialogEventO. 

If C IsDiaiogEventf eventPtr ) } 

I 

If IsDialogEventO returns tme, the event is associated with 
our modeless dialog box and well pass it along to 
DoDlalogEventO for processing. 

DoDialogEvent( eventPtr J: 

I 


If the event is not associated witli a modeless dialog, we’ll 
process the event as we always did, using a switch statement. 

else 

I 

switch { eveTitPt]:-)what ) 

[ 

A mouseDown is handled by HandleMouseDownO, 

case nEouseJ]Dwxi; 

MandleMoufieDownt eventPtt ): 
break: 

keyDown and autoKey events are turned into characters and 
turned from command-key equivalences (if appropriate) into 
menu seiectic}ns by MenuKey(). The menu selections are handled 
by HandleMenuChoice(), 

case keyDown: 
case autoKey: 

theChar “ eventPtr'>aie3sag,e & chatCodeMask: 
if ( {event Ft r->iiiodifiers 6 cmdKey) != 0 ) 
HandleMenuCholcet MeuuKayC theChar ) ): 
break: 
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updateEvIs are handled by DoUpdate(). Since the update 
events for our modeless dialog will have been diverted to 
DoDialogEventO, any updateEvts passed to DoUpdate() will be for 
the My Pet Fred window. 

case updateEvt: 

DoUpdate( eventPtr )r 
break: 

I 

f 

1 

All events for the modeless dialog are passed to 
DoDia!ogEvent(), 

r******** DoDialogEvent *”*"’•*"*/ 

void DoDialogEvent( EventRecord *eventPtr ) 
f 

short itemHit; 

short iteuiType; 

Handle iteniHandle: 

Rect iteaiRect; 

short ciitRadioButton. i: 

char theChar: 

Boolean becoiJiingActlve: 

MeouHandle dEnu; 

OlalogPtr dialog: 

We’ll start off by fetching a handle to the File menu. Why? 
We're going to dim the Settings item if the modeless dialog is up 
front. Remember, we’re doing tills just to demonstrate how it’s 
done, not because it's needed. 

zDsnu " GetHenuHandle( wFile ): 

Notice that we process keyDown and autoKey events in two 
different places. If the modeless dialog is up from, 
DoDialogEventO will get all keyDowns and autoKeys. If the 
modeless dialog is not up front or is not open, the normal event 
handling mechanism will get the keyDowns and autoKeys, 

switch ( EventPtr- >what ) 

1 

case keyDown: 
case autoKey: 

theChar = eventPtr->message & charCodeMask; 
if t CeventPtrOmodifiers cmdKey) 1 “ 0 ) 
HandleMenuCholce ( tienuKey C theChar ) ) ; 
break; 

If die modeless dialog window is either being activated or 
deactivated, DoDialogEventO will get an activateEvt. In that case, 
wee’ll use the activeFlag to determine whether becomtngActive 
should be set to true or false, 

case activateEvt: 

becotningActive ^ t {eventPtr->inodifier3 S activeFlag) 

” activeFlag ): 

If the modeless dialog window is becoming active, we'll use 
HiliteControlO to enable all the radio buttons, from kFirstRadio to 
kLastRadio, then we’ll disable the File menu’s Settings item. 

if t becomingActive ) 

[ 

for ( i^kFirstRadio; i<=kLastRadio: i-i-H ] 

[ 

GetDialogItem( gSettiHgaDLOG. i, ^IteinType, 
fititainHaiidle. SitemRect ): 


HxliteControlC (ContrQlHandle)itemHaBdle, 0 ); 

] 

DisahleIteiQ( menu. iSettings ] : 

] 

If the modeless dialog window Ls being deactivated, well 
dim all the radio buttons and enable the Settings item, When the 
user goes to the File menu and sees that Settings is dimmed, 
they’ll have a clue that the mcxleless dialog is already up front 
and ready to use, 

else 

I 

for ( i“kFlrstRadio: i<”kLastKadlo; i-H+ ) 

[ 

GetEialogItem( gSettingsDLOG* iitemType. 
&iteinHaTidle, iiteinRect ): 

HiliteControl( fControlHandle)itemHandle. 255 ): 

] 

Enableltemt menu, iSettings ); 

] 

break; 

f 

The previous chunk of code accomplished two things. First, 
it made sure diat command-key equivalents were supported. 
Second, it made any user interface adjustments that were not 
normally handled by the Dialog Manager. We decided to dim the 
radio buttons when the modeless window is deactivated and dim 
the Settings item when the modeless window is activated. These 
user interface adjustments are window trimmings that we 
decided to add. The program would still work without them. 

Next, we’re going to the things that absolutely must be 
done. DialogSelectO is the modeless version of ModalDialog(}. 
DialogSelectO takes the event pointer and maps it to a specific 
dialog and a specific item in the dialog. DialogSelect() returns true 
if we need to do some processing (if an item was actually hit), 

if { DialogSelect ( evefitPtr, fiidialog, iitemHit ) ) 
t 

Since our dialog was relatively simple, we know that itemHit 
is going to be one of iAfghan, iElephant, or iSquirrel. 

switch C ItemHlt ) 

1 

case iAfghan: 

case iElephant: 

case iSquirrel; 

Before we process the radio button click, we'll first calculate 
which radio button should be currendy lit. 

curRadioButton ^ gCurrentPICT - 
kBaseResID + kFirstRadio; 

If the button that was clicked in is not the current radio 
button, we've got some work to do. 

if { curRadioButton itemHit ) 

i 
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First, well turn off the current radio button. 

GetDialogltem{ dialog, curRadioButtoo, &ltainTypa. 

^tGTnHandlG. iitamRecLt )r 
FllpControK (ControlflandleJ IteinHandle ); 


Next, well turn on the radio button tliat was just clicked. 
Remember, always turn off a radio button before you turn on a 
new one. 

GetDlaloglteiat dialog, itemEit* SiternType, 

& i t emHa nd 1 e * & i t euiRect ); 

FlipControl( (CoatrolEaGdlEjitGmHandle ); 

Next, update curRadioButton to reflect the newly clicked 
radio button. 

curRadioButton “ ItGmfiit: 

Next we check to see if the current PICT is still up to date, 

if t gCurrentPICT curRadioButton + 
kBaseResID - kFirstRadio ) 

( 

If not, we'll set it to its new value, then call SwitchPtCT() to 
update the My Pet Fred window. 

gCurrantPICT " curRadioButton + 
kBaseResID - kFirstRadioi 
SwitchPICTOi 

1 

] 

break: 

I 

1 

1 


HandleMouseDownO works much the same as always. 

HandleMouseDown **********/ 

void HandieKouseDownt EventRecord *evGntPtr ) 

I 

WlndowPtr windov: 

short thePart: 

long menuChoice; 

MenuHandle manu; 


First, we call FindWindow{) to find out what window tlie 
mouseDown tvas in and where in the window the mouseDown 
occurred. 

thePart = FindWindowC eventPtr->wherG, ^window }: 

If the mouseDown w^as in the menu bar, pass the menu 
selection on to HandleMenuChoice(). A mouseDown in 
inSysWindow gets passed on to SystemClickO. 

switch ( thePart ] 

I 

case inMenuBar: 

menuChoice = MenuSelectt eventPtr-)where ): 
HandleHenuChoiceC menuChoica ); 
break: 

case inSysWindow i 

SysteraClickC eventPtr, window }; 
break: 


A mouseDown inContent causes a call to SelectWindowO to 
bring the clicked-in window to the front. 

case inContant! 

SelectVindow( windov ); 
break: 

Note that tliis line will get executed even if the mouse click 
was in the modeless dialog, but only if the modeless dialog was 
in tlie back w'hen it was clicked in. Want to prove this? Try adding 
this line after the call of SelectWindow() but before the break: 

if { window =" gSettingeDLOG ) SysBeapt 20 ): 

If the mouseDown was inDrag, call DragWindow() to drag the 
window around cm the screen. 

case inDrag : 

DragVindowC window, eventPtr->vhere. 

&qd, acreanBits.boundfl ); 
break: 

This next case is interesting. If the mouseDown was 
inGoAway, call TrackGoAwayO to ensure that the mouse button 
was released inside the close box. 

case inGoAway; 

If ( TrackGoAwayf window* avGDtPtr->wherG ) ) 

If SO, verify that the dick was in the modeless dialog's close 
box (the only window with a dose box, by the way). 

if ( window ™ gSettingsDLOG ) 

[ 

If SO, make the modeless dialog window invisible. Why not 
ckjse tlie window? We want to keep tlie d ialog around so if the user 
brings it back up, it will have tlie same settings and will be in the 
same po-sition, without us halving to keep track of all that stuff. 

HideWindow( window ): 

Once the window is hidden, weil enable the File menu's 
Settings item. 

menu ^ GatMenuHandla( hiFIIg ): 

Enablelteni{ Tnenu, iSettings ): 

I 

breek; 

I 

t 

HandleMenuChoiceO does what it always has, dispatching 
menu selections to the Apple and File menus. 

HandicMcnuOiaicc 

void HandleHenuCboiceC long manuChoice ) 

[ 

short menu: 
short item: 

If ( menuCitoice E= 0 ) 

( 

menu = HiWordt menuChoica J : 

It GEL LoWord( manuCholca ) : 

switch ( menu ) 

I 
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Running a program from the command line, setting the classpath, installing a Java virtual machine... with so many things to contr[)l, 
how can you be sure that your Java application will function correctly on a user's system? Fortunately, there's InstallAnywhere 2, the 
most powerful tool for distributing Java software, InstallAnywhere 2 creates a single, universal installer that runs on any platform. 
Whether installing on Windows SS/NT, Solaris, or Mac OS, InstallAnywhere puts you in control of your Java software installation. 



-***The InstallAnywhere attthnring 
tool gives you complete control 
over every aspect of your 
installer. Or, use InstailAnywhere 
2's new Proiect Wl 2 afd to bn I Id 
simple installers in just 6 steps. 



Install directly tram the Internet 
using InstallAnywhere 2^5 new 
Wet Install feature. 

Installers automatically install a 
Java VM. create icons and 
shortcuts, make registty entries 
. . . everything you needed to 
build professional installers, 



InstallAnywhere Is the only product on the market that fills the gap in 
the ‘write once, run anywhere'Java story.... Given its power, flexibility, 
and ease-of-use, InstallAnywhere is clearly the tool of choice for 
installing and running Java software. _ jggg 
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case mApple: 

HandleAppleChoicet item ): 
break; 
ca.se mFile: 

HandleFileChoice( itera ); 
break; 

1 

HiliteMenu( 0 ) ; 


HandleAppleChoiceO puts up an alert if the first item on the 
Apple menu was selected. An alert is like a dialog, but is not 
interactive (other than dismissing it), llie alert comes up and is 
then dismissed, usually by a button click. Read the section on 
alerts in Inside Maciniosh: Macintosh Toolbox Essentials. Alerts 
are not complicated. 

r* .HandleAppIcChaicc 

void HaiidleAppleChoice( short item ) 

[ 

NenuHandle appleMenu; 

Str2b5 accNanie; 

short accHumber; 

switch ( item ) 

[ 

case iAbout: 

NoteAlert( kAboutALKTid, NULL ): 
break: 
default: 

appleMenu = GetMenuHandle( mApple ); 

GetMenUltemText( appleHenu. itemp accName ); 
accNumber OpenDeskAccC accNaitie ); 
break; 


HandleFileChoice() handles the two items in the File menu. 
/“*“**“♦ HandkFUeChoice 
void HandleFileChoice( short item ) 

f 

If Settings was selected, we first check to see if the modeless 
dialog was created yet, If not, we create it by calling 

CreateDialog(). 

switch ( item ) 

I 

case iSettings; 

if ( aSettlngsDLOG = NULL ) 

CreatcDialogO ; 

If the dialog does exist, we make it visible and bring it to the 
front. How does the Settings... item get dimmed, you might ask. 
When the dialog is broughl to the Front, an activateEvt gets 
posted, The activateEvt handling code takes care of that. 

else 

( 

ShowWindow( gSettingsDLOG ): 

SelectWindowt gSettinguDLOG ); 

] 

break; 


As always, when Quit is selected, we set gDone to true and 
drop out of the program. 

case iQuit: 
gDoue = true: 
break: 

I 

1 

Since events for the modeless dialog am handled elsewhere, the 
only update event this code will see is for the My Pet Fred window, 

/*•*«**«• DoUpdate •««^***/ 

void DoUpdate( EventRecord ‘eventPtr ) 

! 

PicHandie pic: 

WindowPtr window: 

Rect r: 

Well retrieve the WindowRr from event Rr-> message and 
load tlie current Fred PICT using LoadPICT. 

window = (WindowPtr) eventPtr->nies sage: 
pic = LoadPICT[ gCurrentPICT }r 

Next, we make the window the current port, call 
BeginUpdaleO, then draw the newest version of Fred and call 
EndUpdate(). 

SetPort[ window ); 

BeginUpdate( window ); 

r ” witidow')portRect: 

DrewPicture( pic, &r ): 

EndUpdate( witidow ); 


Just as we'd do with a modal dialog, we load the modeless 
□LOG resource by calling GetNewDialog(). 

r****^** CreateDialog ****^**^/ 

void CreatehialogC void ) 

( 

short iteniType: 

Handle itemHandle: 

Rect iteraRect; 

short curRadioButton: 

gSettlngsDLOG “ GetNewDialog( khialogResID, 

NULL. kMoveToFront ): 


If the DLOG couklnl be loaded, beep once tlien exit. 

if ( gSettingsDLOG = NULL } 

I 

S 7 sBeep( 10 ); /* CoLildn‘I load the DLOG resource!!! 7 
ExitToShellO : 

1 

Once the DLOG is loaded, make the dialog window visible 
and die current port. 

ShowWindow( gSettingsDLOG ): 

SetPortf gSettingsDLOG ): 
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Next, turn the cuirent radio hunon on. 

curRadioButton “ gCurrentPlCT ■ kBaseHesID ^ kfirstRadioj 
GetDlaIcigItBJii( gSettlngsDLOG. cur Radio Butt tin* SiternType. 
SitemHandle* &itemRect ): 

SetGontrolValue{ (ControlHandle) itemHarvdle, kOn ): 

1 

FlipControlO turm a radio button or check box that’s on, off 
and one that’s off, on. 

FiipContral 

void FiipControl( ContrqlHandle control ) 

{ 

SetCoTitrolValuet control* 1 GetControlValuet control ) ): 

1 

SwitchPICTO calls DisposeWindow{) to free up the memor>' 
used by the specified window (this closes the window as well) 
and then calls CreateWIndowO to create a My Pet Fred window 
that reflects or most current choice of pet. 

/•*“*“*• bwitchPia "«**«*7 

void SwitchPICTC void ) 

{ 

DlapoaeVlndovC gFredWlndow ); 

CreateWIndowO 1 

) 


Running Modeless 

Save your source code and you're ready to run. Select Run 
from the Project menu to compile and run your program. When 
the program runs, the My Pet Fred window wiD appear, showing 
PICT 128. Pull down the Apple menu and verify that the first item 
reads About Modeless. Select About Modeless, from the Apple 
menu and check out your About box. Are your changes all there? 
Click the OK button to dismiss the About box. 

Hold down the mouse in die File menu and verify that the S 
command-key equivalent was added to the Settings item. Selea 
Settings. The Settings dialog box should appear (Figure 12). 


ila^^ Fred Settings 

Pick one: O Afghan 
O Elephant 
(§) Squirrel 


Figure 12. The Settings... mmial dialog box. 

Click the My Pet Fred window, bringing it to the front and 
sending the modeless dialog to the back. Notice that the radio 
buttons are dimmed when the dialog is no longer the front-most 
window (Figure 13). 


Fred Settings 


Pick one: 

O 

(§) 


Figure IJ. The radio buttons are dimmed 
when the dialog box is not in front. 

Now type the command-key equivalent S to bring the 
Settings dialog to the front again; the radio buttons should be 
enabled. Click die Elepliani radio button. Notice that the My Pet 
Fred window changes appropriately, leaving the Seidngs window 
in front. Click a few more radio buttons. While you are at it, click 
the File menu. Notice that the Settings item lias been dimmed. 
Though this doesn't help us much in this program, it's important 
to be able to disable and enable certain menu item.s when a 
modeless dialog is in front. 

When you are satisfied with your pet selection, drag the 
Settings window to another part of your screen. Now click the 
close box. The Settings window disappears. Select Settings 
from the File menu. The Settings window reappears at the 
position it was in when it disappeared and with the same 
radio button settings. 

Finally, type the command-key equivalent Q to exit the 
program. 

Till Next Time„- 

WeU, lhafs about it for modeless dialogs. Be sure to read 
the Inside Macintosb: Macintosh Toolbox Essentials chzpi^Ts that 
penain to dialogs and alerts. In a future column well spend 
some time with a filterProc, a procedure that you provide to the 
Toolbo, and that the Toolbox calls for you, Tlie filterProc allows 
you to control how the user interact with a dialog box, including 
what text the user can type. You can read about filterProc in 
Inside Macintosh: Macintosh Toolbox Essentials in the 
description of the Dialog Manager routine ModalDialog(). 


Want to get up on a 
soap box? 

Send your opinions to 

<mailto:letters@mactech.coin> 
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JAVATECH 


by Steve Sheets 


Java Development Environments 


A look at Metrowerks 
CodeWarrior using Java 
and Symantec Visual 
Cafe for Java 


State of the Mac 

Until now, there has probably been a 
larger indusny in writing ahour Java 
programming than actually programming 
in this new computer language. Tliis may 
finally be a tiling of the past. I'here are 
significant reasons (Web usage, cross 
platform alhlity, Internet tools and {Jthers) 
for Macintosh programmers to learn and 
use the Java environments. 

This article is not intended to sing 
the praise of or explain liow to program 
in Java, but to quickly educate the 
Macintosh programmer about the Java 
tools that he can use. We will examine 
the two most common Java IDEs 
(Integrated Development Environments): 
Metrowerks CodeWarrior using Java and 
Symantec Visual Cafe for Java. Each tocjl 
offers a different approach to developing 
Java and has different strengths. In this 
article we will discus.s the current release 
of both IDEs, CodeWarrior Fro 2 and 
Visual Cafe 2,0, The next revision of both 
products may be out soon after this 
article is printed. We will also explain 
some of the promised new features. 


Metrowerks Java; One More Language Target 

It is fair to say that the premier tool for Macintosh 
programming is Menowerks' CodeWarrior It is by far the most 
popular programming environment. Even the developers who 
use other IDEs recognize Code Warrior's advantages. 
Programmers can develop Macintosh and PC programs in C, C++ 
and Pascal and now in Java, 



Figure L CodeWamor Appearance. 


Metrowerks accomplished this by adding Java features to 
existing IckjLs, ratlier than building all new one.s. Java developers 
u.se die same IDE that Mac developers have been wx>rking with for 
years. Programmers ci eate CodeWarrior project files to manipulate 
sets of targets and source files. The same refined and ix)werjfu! 
editor is used to manipulate Java source files. In fact, if BBEdit 
users wish, they can continue to use BBEdit (from Bare Bones) as 
a replacement editor. Programmers also will not be surprised to 
find the Metrowerks' source level debugger (MWDebug) has been 
updated to handle Java code. The Class Browser, Constructor and 
Profiler twis also have Ix-en updated to run widi Java code. 


Steve Sheets <MageSteve®AOL,Coiii> has happily programming the Macintosh since 1983s which makes him older dian he 
wishes, f^ut not as young as he acts. Being a native Californian, his developer wanderings have led him to Northern Virginia. For 
those interested, bis non-computer interests involve his family (wife and 2 daughters), Society for Creative Anachronism (Medieval 
Reenactment) and Martial Arts (Fencing, Tai Chi), He is currently an independent developer, taking on any and all projects. 
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figure 2, CodeWarrior Editor. 


Metrowerks has added Java support by adding a Java 
Compiler and a Java Linker (both IDE plugdns), along with a few 
other tools (JavaDoc, Class Wrangler, Java Constructor), including 
several Virtual Machines (VMs). Remember, Java is both a 
language and a target platform. You must understand this or the 
rest of tills article will not make sense. When a Java developer 
compiles a source file, it is converted into bytecodes, not into 
680(K) or PowerPC assembler. These bytecodes are designed to 
run on a Java Virtual Machine (VM). The VM will interpret the 
bytecodes (or compile them, using just-in-time technolog>0 into 
w'hatever native code runs on a specific platlbrm. 



^JlQWbound soflte^ 

^ HIGH PEBPOBHANCE 



Imaging, Annotation & Plug-in 
Development Tools 


RasterMaster 7.0 Powerful, multi-platform raster 
imaging support for 60+ Raster Formats. Familiar API and 
well^proven technology fn use worldwide by companies 
such as BP. Chase Manhattan, Ford, Gannett, HP, IMSI, Kodak, 
LEXIS-NEXIS. Polaroid, Toyo, Unisys, Xerox and morB. 
Formats: TIF, JPEG. MO:DCA, CALS, PNG, DICOM, Flashpix, 
BMP, BRK, G3, G4. GIF, JED, KFX, MAC, lOCA, PCX, TGA, 
WFX and more. Features include: f New for Version 7) 

- Compression • CMYK 4 Plane Support * 

- Image Processing -10-16 bit Gray Scale * 

- Despeckle & Deskew ^ Anti-Aliasing in Silver * 

- Multipage TWAIN Scanning “ Fit to Width & Height * 

Pan, Zoom, Scroll - Tiled Image Support* 

^ I mage Editing ^ M ed ical I mag ing 

• Auto Aspect Ratio * Animated GIF * 

- Alpha Channel Support * - Image Encryption * & rnom 


Rastt^rNote 2,0 Annotation/Redlining toolkit. Features 
include: Sticky Notes, Lines, Ellipses, Freehand Drawing, 
Polygons, Highlighting, Redaction, Multiple Annotation layers. 


Rasli*j*Net 2.0 Ptug-in for Netscape and Internet Explorer. 
Read 60+ Raster FormatsI Simple drop In library makes it easy to 
enable standard browsers to read your Intemet/lrrtranef pages. 


Platforms Include; Win 95/W, Win 3,x, Mac 68K/PPC, UNIX. Alp^, OS/2 
Languages: DLL, VBX, ACtivaX/OCX, Delphi, FoxPm, PB, VC++ 

Call 617^630^9495 Or Visit Us At 

WWW wtond.com 


What a Joy! 


AAA ^ 



r/)e Joy-enhanced Interface Bultder appfkation becomei your single apptication 
c/eve/o/oment environment Graphkaify link variabfes to interface elements to 
contfoi the etements’ behaviour, Add scripts to the \nfb* f/Ze Save yoor 
interface file as a stand-alone application. Test your application immediatety. 

No compiling. No linking. No need to reiaunch the application. 



Joy Developer 

by AAA+ Software 

EnJoy overtaking your competitors! 

B Don't waste your precious time with compiling, 
linking, and re-establishing complex test scenarios 1 
B Create standalone applications that run on any 
Yellow Box platform just by saving nib files with 
the Joy-enhanced Interface Builder, 

B Quickly try out new ideas. Script. Debug. Prototype. 

Extend the functionality of Yellow Box classes. 

B Freely mix interpreted scripts and compiled code. 

Implement new services as scripts. 

B Modify and enhance any existing application. 
Automate your testing with Tcl scripts. 


Available for Rhapsody RFC, Intel, 
Windows NT/95, and OPENSTER 

Email your order today: 
o rder@aaa-p I u s xo m 

Download a FREE derno 
version from our website: 
h ttp://Www, aaa-pl us. com/joy/ 
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After the Java compiler converts the Java text source into 
standard Metrowerks objea files* and after the Java Linker has 
converted the object hies into some executable target, some VM 
must be used to execute the code* When a developer uses the 
Metrowerks CodeWarrior for Java, he has three versions of the 
VM available. Metrowerks decided to ship two separate versions 
of their VM: one with JITc (just-in-time compiler), and one 
without it. They recommend using the non-JlTc version for 
debugging, and using the faster JlTc version in die finished 
product. Both versions suppon the JDK IT API. They also 
included a pre-release version of MRJ 2.0 from Apple (which also 
was supports the JDK 1.1 API), The final MRJ 2,0 (shipped with 
BT) works flawlessly with Metrowerks Java. 

For those familiar with Metrowerks' array of options for 
C++ Compiler, the Java compilers options are few and easy to 
understand. You can use the Profiler Information option to 
generate timing information. You then use the MWProfiler tool 
to examine this information. The compiler also can generate 
Dependency Maps. These maps list all the class dependencies 
for each class in the target. Other compiler options include 
inlining of small methods, using strict source and package 
hierarchy paths, using strict Java filenames, giving warning 
messages about depredated inetliods, creating lieaders for any 
native methods (using JNl style headers or Sun VM style 
headers) and using semicolon delimited list of names that will 
nc^t show' up in the class browser, 

Java Outputs 

Tliere are three types of executable targets that the Java 
Linker j>rtKluces; Applets (intended to Ire run inside of Web 
Browser such as Internet Explorer or Navigator), Applications 
(stand alone cede to be run under a VM) and Java Libraries. All 
three types of output are available as template projects, W'hich 
quickly automate tlie process of creating a project. All three 
outputs can be generated three ways: as class files (JDK 1.x 
metlrod to distribute executable files), as JAR files (JDK 2.0 
method that uses compression similar to ZIP) and as Macintosh 
executables (not true 68(X)0 or PowerPC executable, mcjre alic^ut 
this in bit). JAR files are quickly becoming the best method of 
output. They come in compressed and uncompressed versions, 
and can have manifest files (a JavaBean feature) generated for 
them. Unfortunately, there is no direct control of the content of 
the manifest files, thought this may be changed in future versions. 

When an Apjrlet is generated, the developer ran specify the 
browser that will Ire used to display foe Applet. While fois can be 
any browser (Apple's Applet Runner. Netscape’s 
Commimicator/Navigator, MicrosofVs Internet Explorer), 
Metrowerks supplies it’s own default tool, ''Metmwerks Java”, 
They could have been a little less confusing with that name! This 
application contains several utilities, including simple and 
command-line interfaces for executing Applets and Applications, 
a bytecode disassembler, the Sun version of the Java Compiler, 
and a Native Code Generator (to create C interface files). 
Experienced Sun Java users would consider this foe “Java” tool for 
the Macintosh. Metrowerks Java is the only way Java code can be 


debugged by the Metrowerks’ source level debugger When either 
of Metrowerks’ YMs are selected and the Java files are compiled 
with debug information, MWDebug can be used to step through 
the code being executed by the Metrowerks Java application. 



Figure 3- CodeWarrior Debugger 

MWlDebug has been updated for several Java specific 
features. The developer can view a disassembly of the Java VM 
instructions and registers, view and debug several threads at the 
same time (each in if s separate process window), and set break 
points on lines of source code or Java exceptions. So far, JAR 
compressed files can not be debugged, though this may change 
in foe future. Metrowerks will be updating CodeWarrior to allow 
debugging while running other browsers (Applet Runner, 
Internet Explorer) in the near future. Debugging applets while 
riEnning under Netscape products may take a little longer, 
because foey use only their own VM. 

Rather than creating a Java Ckss file or JAR file, a developer 
can output a Java application as a Macintosh application. Theie 
are two flavors of such an output; one without VM embedded and 
one with VM embedded. Both flavors have the advantage of 
being double-clickable like any Mac application, and being able 
to have their own custom icons. The non-VM version still runs 
either Metrowerks or Apple's VM in order to execute. There are 
sjx^cific rules about where foe VM must reside in relation to foe 
application foe programmer has developed. The VM version has 
the bytecodes as well as an entire copy of a Virtual Machine 
inside foe application as resources. Java does not have to be 
installed on the taiget computer for this type of application to run. 
The main disadvantage of the VM version is size. The embedded 
VM takes over 5 Meg of hard disk space per application. 

For now, this is the only way to use Java CodeWarrior to 
create true stand alone, Macintosh applications. Metrowerks has 
promised a true Java to native code product in foe near future. 
This would create true Macintosh applications from Java source. 
The CodeWarrior Pro 3 release may have a prototype of such a 
feature, though it will probably support x86 native code first, 
foRowed by 68000 code, tiien PowerPC native. When the Mac 
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and Windows versions are completed, we will see some of the 
promise of commercial cross platform usage of Java. 

Other CodeWarrior Tools 

One other useful Java tool is the JavaDoc compiler/linker. 
This tool processes Java source code files to generate HTML based 
documentation for tlie code. It uses the comments preceding 
classes and methods for it’s content. This tool Is often used on the 
Sun workstations to produce the manuals. Since Metrowerks use-s 
JavaSoft's Compiler, the tool is implemented as a compiler/linker. 
To use it, you must add another target to the project file, setting 
the JavaDoc target option. Code Warrior's various project templates 
include the JavaDoc taiget. The options for this tool include 
deciding which comments are ignored, the scope of the 
documentation, and whedier to generate indexes or liieraichies. 

Class Wrangler is a utility for viewing and modifying JAR 
files that contain Java classes, 'fhese Java Classes can be added, 
removed or copied to other JAR files, [nformation like source 
files, super classes, interfaces, methods and fields also can be 
viewed. You can add or remove manifest files, but there is no 
direct support for modifying tliem. 

One last feature worth mentioning is Metrowerks' Java 
Constructor, The original Construaor was a RAD tool for 
designing user interfaces for PowerPlani. The Java Constructor 
application is a visual interface builder for the Java Abstract 
Windowing Toolkit, or AWT. Layouts, Windows, Components, 
Containers, Menus and Menubars all can be created and used 
inside applets and applications. The Constructor uses a project 
file similar to the CodeWarrior IDE. The output of the visually 
constnjcted project is a Java source file which can be used 
directly by a Java project. The Java project need make only a 
couple of simple calls and include the generated java file and a 
Reanimator.zip file to invoke the user interface. Unfortunately, 
this tool has not been updated to support the new JDK 1.1 Event 
Model and JavaBeans. 

As alw'ays, Metrowerks ships all of their documentation on 
CD, The hard copy book “Inside CcKleWarrior Professional 
Release containing some of the manuals (including the 
“Targeting Java” section) usually c'an be purchased soon after that 
revision of the product ships (for around $40 dollars), 
Metrowerks makes up for not shipping the printed version of the 
manual by including many additional manuals and Ixioks on a 
second CD. This includes most of the Sun documentation and 
examples, as well as some very good Metrowerks examples. In 
addition, Dave Mark’s book “Learn Java on the Macintosh” is 
included on the CD for free. 

System Requirements 

Metrowerks minimum requirement for running CodeWarrior, 
regardless of target language, is an 68020 Mac (or belter), 8 Meg 
of RAM, System 7.1, CD ROM drive, and a very large hard drive. 
(Installing all the feamres, called Metrowerks Heaven in the 
insLiiler, can take over 400 Meg without all the documents and 
examples!) Even Metrowerks recommends at least 68030 Mac 
with l6 Meg of RAM (a PowerPC would be best). While the IDE 
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is a fat Mac application, realistic developers would consider a 
PowerPC Macintosh a truer requirement. The more RAM, the 
better! Installing only tlie Java portion of the Metrowerks IDE 
requires a Hide over 100 Meg of disk space, not including 
examples and documentation, which are separate. 

Metrowerks CodeWarrior is sold for $449 and includes the 
Mac and the Windows version of the product. Purchasing die 
product provides one free upgrade (they come out regularly) and 
one year of tech support. Tech support answers feature questioas 
more readily than programming quesdons. 

Visual Cafe: RAD For Mac Java 

Symantec took a different approach when creating Visual 
Cafe 2.0. They wanted to create a Macintosh Java Rapid 
Application Development tool. They have succeeded beyond the 
greatest expectations of Macintosh developers. In the Mac 
package, there is no C/C++/Pascal support, no Windows 
support, and there is no custom VM. The Windows version of 
Visual Cafe is a separate prodoa. Visual Cafe ships with a pre¬ 
release version of Apple's MRJ 2.0. Java applications run from the 
desktop, and die default setting has Applets executed from 
Apple's Applet Runner. 

Visual Cafe is built around components, forms and project 
files. A component is a user interface element (called a visual 
component) or a logical endty (called an invisibie component) 
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thai can be attached to the Java program. For example, buttons 
are visual components, wliile timers are an invisible one. The 
first thing a programmer notices when starting Visual Cafe Is the 
floating tools palette across the top of the window. A 
configurable list of components is displayed on the palette using 
a tab interface. These and other components also are in the 
Component Library Window. All components have properties 
which include their icon and position. 





Figure 4 Vluiai Cafe Appearance. 


Forms are containers for other components, like windows, 
dialog boxes and applets. When opened, they appear like a 
dmwing program, with any components attached to iliem visible 
on the form. Components can be moved around, added to and 
deleted from the form, just like drawing primitives are modified 
on a drawing document. Forms arc themselves components, and 
as such can be added to tlie Component Library. 

Project files keep track of the files that Visual Cafe is 
CLirrenily working with. The project window can be set to show 
the files, the objects (components) or the packages (targets to he 
created) Selecting an item from the project file invokes the 
appropriate editor. 

To create a Java applet or application, the user selects a New 
Project template. Since such templates are themselves 
components, they can be added and removed from the IDK by 
the developer Usually the project has some preset files, forms 
and components. Components on the form are linked to the 
source code files. The user opens the forms using the Forms 
Editor, and modifies the componenLs on it, w hich causes changes 
to the source code. Similarly, changes to the code using the 
Source Editor can change the fomis layout. Both editors function 
the way developers would expect witli Find/Replace/Grep 
features, Layout Menu Items and Insert Menu Items. 

Besides moving components on the form, the developer can 
edit components in other ways. Each component has properties 
associated with it. When the Property window is open and a 
component Is selected, the Property window displays the 
editable properties for the programmer to change. Thi.s is similar 
to using ResEdil to open and change a resource. Changes to the 
property of a component will be reflected in the code. 


Which type of component you modify is unimportant. 
Adding a component to a form might create simple Java AWT 
drawing commands, or it might generate code to create a AWT 
object like a Bbutton, or it might generate code to instantiate a 
JavaBean. To help generate code, Visual Cafe has a set of 
powerful tools called the Interactive Assistants. These tools may 
also be referred to as Wizards (the common name for such 
utilities in the Windows world). Double-click a component, and 
the Add Event Assistant appears wltli a list of all events for that 
component. Selecting an event will automatically generate source 
code to handle tliat event. Tills usually generates some empty 
method source, which tlie user can modify. 

Some component actions can be linked to already defined 
methods on other objects, thus creating programming logic 
without the developer typing a single line of code. Menu Editor 
is used in .similar way to handle Menu EvenLs inside the Java 
ccxle. Similar Assistants exist to link two components together, to 
create dependency. The Insert Class Assistant quickly creates 
custom classes in die Java project, tlie Java Ekan Assistant 
automates the formerly difficult process of JavaBean creation. 

The ease of Visual Cafe development can not be 
understated. You can create entire Java applets graphically 
without any code being entered. When new routine need to be 
added, Visual Cafe handles the in.sertion of empty mediods with 
a simple few clicks. You do not have to look up the call, or the 
correct parameter list or fonnai. Adding additional code to 
existing programs is tliat simple! 

Java Outputs 

Once the source is created, the developer outputs the code 
in the three standard formats; applet, application and library. 
Each output is compiled in a debug version (with debugging 
information) or a final version (without debugging information, 
thus smaUer). The three outputs are in the form of class files, a 
zip file or the newer JAR file fomiat, either compressed JAR or 
uncompressed JAR. If the output is an application, there is an 
additional option of creating a MRJ Application. 



Figure 5- Visual Cafe Project Options. 
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A MKJ application is a stand alone Mac application, thus it 
has custom icons and is douhle-clickabic. Since tliis application 
still uses l^ytecodes, it requires Apple's MRJ on the computer. You 
do not need a separate tool to invoke the application, but tliere 
is no command line interface. The command line for the 
application is set as part of the compiler options. MKJ 
applications arc the only way to run Visual Cafe created 
applications on the Macintosh. If tJie developer wants to generate 
a JAR file, and the MKJ Application option is turned off, but the 
he .still warns to run or debug the application, the MKJ 
application is still created and invoked. 

Symantec hope.s to have a Java to Mac Native code conipiler 
before long. The Windows versions of Visual Cafe already has an 
early release of this feature. Window^s Visual Cafe can compile a 
Java application directly into x86 code. Such an application can 
be executed on any PC even if Java Ls not installed. 

As long as the MRJ VM is being used to execute tJie applet or 
application, Visual Cafe can use it's built in source level debugger 
Any browsers iliat supyxjit MRJ can run the Applet, while Visual 
Cafe steps through the actual code. Tills includes Apple’s Ajiplet 
Runner, Symantec's Visual Page, and depending on die release, 
Microsoft's Internet Explorer. TTie debugger axils are what one 
expects w idi Watch, Call Slack and Breakpoints window's. TTie txxle 
ctin have a breakpoint at a source line or it can lirtak due to a Java 
exception. The debugger easily steps tlirough the various defined 
class libraries, which is a gcxxl way to learn alxiut the framew'ork. 
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Take control of your Mac system! 
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• Two groups of switched outlets 
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automatically restart crashed 
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Figure 6, Visual Cafe Editor/Dehugger 


Other Visual Cafe Tools 

Jav^Doc, the utility to convert Java source code files into 
HTML based documentation, is built into Visual Cafe as a project 
option. The developer can set where the document is created, 
whether the Author or Version infonnation should be included, 
whether a index of all the classes should be created and whether 
a hierarchy tree of all the classes should be created. 

Other compiler options include creating optimized code, 
using Finder memory, updating imported files when needed, 
selecting tlie error re^x^rting and selecting the Unicode support 
used. Optimized code runs faster, but is larger due U] inlining of 
methods. Project command include setting search paths, 
disassembling the source, bundling the external classes into the 
project, and removing the class files. The majority of these 
commands are similar to most other project based IDE. Visual 
Cafe has all the project commands you would expect if you had 
used CodeWarrior, just in different locations. 

Visual Pages, an excellent WYSIWYG web authoring ttx>l is 
included on the CD by Symantec. Tliis product will do almost 
everything a web designer needs to do, witliout forcing the 
designer to learn ITfML. llie graphic design portion of the program 
will look familiar to anyone with experience in any draw or paint 
program. For those who like the power of diiedly editing the 
HTML source, there is a mode to do that. One can s’witch editing 
between either mcxle (graphic or HTMIJ without losing changes or 
features. Since Visual Cafe is an editor and browser, applets running 
under it can be debugged by Visual (Cafe. 
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figure Z Visual Page. 


While there is additional documentation on die CD, the 
product ships with 4 printed manuals. There are Getting Started 
manuals for bodi Visual Cafe and Visual Page, as well as the User 
Guides for both products. The applieadon comes with built in help 
documentation Including the Java API Document in hyper-linked 
format. Symantec seems to know tlieir developers will have a 
learning curve, and tries to ease them over it. 

System Requirements 

Symantec's minimum requirement for Visual Cafe is an 
PowerPC Mac, 32 Meg of RAM, System 7.6 wuth QuickTime, CD 
ROM drive, and 80 Meg of disk space. There are two versions of 
the software package. The Professional Development Version has 
all the features mentioned above. The Database Development 
Version includes everything from the Development Version, plus 
features designed for Java database applicadoas. Database 
components include dbAware Project Assistant which quickly sets 
up database-aware applets and applications, Copies of the 
Windows application dbANYWHERE Workgroup Server and the 
Mac applications Lasso and FileMaker Pro are also included on 
tlie CD. Iliere are also diree comparable Windows versions of the 
product (Web Developer, Pn3fe.ssional and Database), The Web 
version lias all the features of the Professional, without the 
incremental debugger and the Java to Native x86 compiler 

The Development version of the product for the Mac is sold 
for $299.95 while the Database version is priced at $499 95. 
Prices for the Windows versions of the product are identical, 
while the Windows Web version is a low $99.95. The upgrades 
have been steady, but are not on any regular schedule, nor is the 
policy for upgrade cost always set. Symantec has Standard Care 
support, which mostly includes installation questions, for 90 
days, starting with the first phone call. Various other paid .support 
packages are available, such as per minute, per call and per year. 

Which is for You? 

CodeWarrior has many advantages, For instance, most 
developers already have it. It will probably be their first taste 
of Java development; they probably used Metrowerks VM 
before they ever installed the one from Apple. CodeWarrior 
has a huge installed base of developers and users. Most are 
already familiar with the IDE and the Metrowerks Debugger. 
Metrow'erks tools have been refined over time, and it show's, 
Developers will feel comfortable with the editor and 
debugger, and will have little learning curve required for using 
the tools. Learning Java is another thing! 

A.S most croas platform developers know, using two 
devekjpment .systems (C++ and Java, Mac and Windows) at the 
same time can drive one to distraction. A programmer is always 
hitting the wrong keys on the wrong software program. A cross 
platform system like CodeWarrior can solve this problem. 

If a developer is creating some Java application while at tlie 
same time creating a Macintosh application (ex. client/server), 
then the ability to have projects with both Java and Mac targets 
is priceless. Similarly, developers who are creating Mac code that 
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calls Java code (or visa versa using JManager), would want to 
use CodeWarrior. Since both the Macintosh and Windows 
versions of the IDE ship with the package, cost effective cross 
platform developers may prefer CodeWarrion 

Anther advantage is that the performance of CcxleWarrior is 
superior This is especially noticeable when running an applet 
and switching to tlie Metrowerksjava application. The compilers 
and linkers are quick and smooth, while invoking an applet 
rakes almost no time at all. 

On the negative side, CodeWarrior is not a Java Rapid 
Application Development (RAD) tool. Once a project 
template has been created, the user is on his own when 
programming Java. The Class Browser and Constructor 
provide some user interface sitpport, but not the capability of 
visually linking actions and events to code. There is no built 
in Java class creator, nor any built in visual tool to link events 
to methods. The Constructor needs to be updated to handle 
JavaBeans, which are quickly becoming the component of 
choice for Java programmers. 

CodeWarrior’s weaknesses and strengths are reversed in 
Visual Cafe. What Visual Cafe does, it does well It uses 
JavaBeans, and to lesser extent all of it's components, the way 
component software was designed to work. It is a breeze to add 
third party' beans or components the programmer makes himself 
Visual Cafe support for creating JavaBeans is hard to beat. For 
developers creating applets with web pages, Visual Page with 
Visual Cafe is an excellent bundle. 

The Interactive Assistants are a joy to use. Using a 
traditional editor under C++, a good portion of the programmer’s 
time is spent creating or editing interfaces of functions. Under 
Visual Cafe, tlie outline of the mediod Is constructed for the 
programmer, all he does is enter the important code. Nor does 
the program need to spend time tweaking the layout of the form 
from the source code. He can graphically lay out the form or 
come back later to change it. 

All of the helpful features of Visual Cafe seem to be at a 
price of performance. Moving from one function to another can 
be slow. Like all applications, this is less noticeable with more 
powerful machines, so the users will have to judge this 
themselves. Learning all the commands and components, while 
not endless (after all, this is RAD), will take time. Symantec 
seems to be aware of this, and tries to offset the problem with 
Online Help, Tours and Examples. One last problem Is the 
definite ‘‘new software” feel of the product. Features are hidden, 
or implemented in ways other than expected. For example, there 
is no debugger command window and too many Command-Shift 
keys. The “software polishing” of Visual Cafe is something that 
will just have to take time. 

Still, Visual Cafe is a RAD tool. Any slow down in switching 
between sections is more than compensated by the speed of 
development of the project. Once learned, Visual Cafe can make 
a major difference in total project time. As JavaBeans become 
more dominant and more available from third parties, the time 
saving in using visual tools will increase. 


Version Control for the masses! 


CWProjector 
and eweVS 

CWProjector and CWCVS are CodeWarrior™ 
plugins that provide effortless access to the 
popular and widely available MPW^” Projector 
and GNU CVS version control systems. 

For $20 you can use version control from 
within CodeWarrior™. Download now from: 

httpiy^www.electricfish.com/hawkfish/CWProjector/ 

http;y/www,electricfish.com/hawkfish/CWCVS/ 



ILECTJRIC FISH INC. 


which one will you use? It would not be surprising to see 
both produces on a developeds hard drive. Many developers use 
CcxleWafTior and MPW at the same time for projects. If 
Metrowerks provide better RAD features, or if Symantec 
“polishes" the product more, one could edge out the other. Until 
then, the best tool for a developer may be the one he is most 
comfortable with. Isn't that always the case? 

Web Surfing for More Information 

Here are some useful sites for Java developers. As alway,s, 
let the developer beware when using Alpha or Beta software. 
There is a reason they call it “bleeding edge" technology! 

• Apple Java Site: <http://www.applejava.apple.com>. 

• Symantec Java Central Site: <http://www.cafe,synnantec.com>, 

• Metrowerks Site: <http://www.metrowGrks,coiTi>, 

• Microsoft Interne! Explorer Site: <http://www.miaosoft.conn/ie/>. 

• Netscape Communicator Site: 

<http://www.netscapeconi/communicator/>. 

• Gamelan Applet Library Site: <http://WWW.gamelan.C0m>. 

• JARS O^va Review) Site: <http://www.ja5.com>. 

• Caffeine Mark 3-0 (Benchmarks) Site: 

<http://www.pendragon-software,com/pendragon/cm3/info.html>. 
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SCRIPTING 


by Dori Smith 


What is JavaScript? 


i4s these examples show, 
it's just a simple web 
scripting language 

Introduction 

What’s JavaScript? W'hat's the 
difference between JavaScript and Java? 
Isn’t JavaScript just a simplified version of 
Java? Tliese are common questions that 1 
get all the time. 

Netscape originally invented a simple 
scripting language called LiveScripi, wdiich 
was to l)e a proprietar>^ add-on to HTML, 
When Sun’s new langtiage Java lx?came 
unexpectedly popular, Netscape was quick 
to jump on the Java bandwagon, and re¬ 
christened their scripting language 
JavaScript. Outside of the first four letters, 
there are almost no other similarities 
lietween the two, 

Microsoft then added their own 
version of JavaScript to Internet Explorer, 
which they named [Script. Unfortunately, 
the two were not ide[itical, so Netscape 
then attempted to straighten matters out by 
turning JavaScript over to ECMA, a 
Switzerland-based .standards body. This 
gave three main versicms of JavaScript- 
based languages: JavaScript, which works 
primarily with Neiscape'.s browsers, JScripl, 
which works with internet Explorer, and 
ECMAScript, with which no browser is 
completely compatible, Netscape and 
Microsoft have both stated that future 
versions will match the ECMAScript 


standard, which should lead to convergence. However, as the 
most-used features are common to all, compatibility is not an 
issue unles.s you are trying to use JavaScript to control DHTML, 

JavaScript is growing in popularity^ due to its simple 
learning curve relative to the amount of power it provides. 
Complete noti-prognmimers are al^le to add a little bit of 
interactivity to their web pages without buying an IDE or 
sweating over why a program won’t compile. Uiere are 
numerous Web sites which contain any number of .scripts 
available Ibr tlie taking, and Netscape has fairly complete 
docLimentation on their site. And of course, there's the always 
useful ability to view the source of Web pages. 

Syntax & Basics 

The syntax of javaScript will be simple to anyone who has 
ever prQgmmmed in an object oriented language. The primary 
object is the window^ wJiich is at the top of the hierarchy. Under 
that are the document, frame, location, history, and navigator 
(jbjects. In turn, the document object contains anchors, applets, 
embeds, forms, images, and links, each of which is an array of 
objects. So, a reference to the first image on a page would be to 
seIf.documenLimagefO], akhough it is preferable to use names 
instead of numbers for clarity. 

JavaScript is not a stand-alone language, but rather a 
scripting add-on to HTML. JavaScript is added to HTML 
commands by use of the <SCRIPT> tag. Anything within this tag 
is (or should be) ignored by browsers that do no! support 
JavaScript. JavaScripL is the most popular scripting language in 
use due Lo iLs cross-platform and cro.ss-bnwser support, 
altlioLigh VTiScript is .sometimes used on intranets when the 
scripter knows that everyone accessing the ]jage is on Windows. 
JavaScript wall attempt to execute the commands within the 
<SCRIPT> tag if there is no LANGUAGE attribute, or if the 
LANGUAGE attribute is set to JavaScript; in addition, the 
LANGUAGE attribute also can be used to distinguish betw^een 
various versions of JavaScript. 


Dori Smith <dQri@ chalcedony xom> is a partner at Chalcedony Consulting, and is the co-author (with Tom Negri no) of 
JavaScript for the World Wide Web, Visual QuickStart Guide, 2nd Edition (Peachpit Press, 199S). 
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Tlie JavaScript in Listing 1 consists of a single line: 
doGU merit.write(“HeHo, World!”). This writes the typical “Hello, 
World” message, using the document.write() method. This method 
dynamically generates text within HTML files, in lieu of hard- 
ccxled HTML. Figure 1 shows the results. 


Lteitog_lj_Everyone’s first script_ 

helltj-himl 

<HTML> 

<EEAD> 

^TITLE^Barely a script at all</TlTLE) 

</fIEAD> 

<B0DY BGC0L0R=WHITE> 

<H1> 

<SGRIFT LANGUAGE=”JAVASCRIPT"> 

doctiment, write {‘'Hello , World'") 

</SCRIPT> 

</Hl> 

</B0DY> 

</HTML> 


□ § Netscape; Barely a scr: 


Back fpr'mra Reload 


Hon! 


;:| Location: |fiU:///lil'^^Obit/Writing 


Hello, World! 


arC 


jm 


Figure L Tbe typical 'Hello, W%rid’\ 


Using JavaScript 

There are tliree ways that JavaScript can be used within 
an HTML file. It can be put within <SCRIPT> tags within the 
<HEAD> tag (header scripts), within <SCR1PT> tags within the 
<BODY> tag (body scripts), or called directly when certain 
events occur 

JavaScript is put inside the <HEAD> tag primarily when you 
are initializing variables and creating functions that will be used 
throughout the entire script Code here is executed once, when die 
page is loaded. Within the <BODY> tag, the best use of JavaScript 
is to write out text on-the-fly. JavaScript handles tliese events: 
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• Create tloating network licenses 

• Tie license to host name 

• Tie license to user name 

• Tie to host ID 

• Allow as many users as desired 

• Have unlimited number of licenses on a network 

• Add licenses on the fly ^ 

• Automaticaliy uniicense if applicotlon is moved or copied 

• Generate expiring licenses for "full strength" demos 

• Works on Yellow Box for Windows as well as MACH/Rhapsody 

• Comes with sample app and license key generator 


From yom fRfems at 


www.stone.com/Licenser/ info@stone.com (505)-345-4800 


Event 

Caused by 

onAbort 

The user aborted loading the page 

onBlur 

Ihe user left the object 

onChange 

The user changed the object 

on Click 

The user clicked on an object 

onError 

The script encountered an error 

onFocus 

The user made an object active 

onLoad 

The object finished loading 

onMouseOver 

The cursor moved over an object 

onMouseOut 

The cursor moved off of an object 

onSelect 

The user selected the contents of an object 

onSubmit 

Tlie user submitted a form 

on Unload 

The user left the window 


Any of these event handlers can be added to any HTML tag 
which can cause the event to occur. For example, the onLoad 
event handler can be added to the <BODY> tag, and the event 
wdll be called when the page has completed loading. 

Image Rollovers 

One of the most common uses of JavaScript is the image 
rollover. This is a technique which requires little 
programming knowledge, but can greatly enhance the 
experience of visiting a Web site. 
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HTML ha.s its place, but it’s static, A user entering a web 
site and seeing a window like that in Figure 2 doesn't know 
what they should do — are these words links, or just graphics 
giving us information? 



Products 

Pricing 

Press 



Figure 2 The Navigation Bar, upon entering the page. 

Adding a rollover to tills gives the tocjk in Figure 3 Now, when 
a user moves a cursor over ^iny of tlie options, it IxTomes dear tliat 
tliis is a navigation Irar, and tliat each of tliese words is a live link. 


Netscape; Navbar S @ 

Back 

Ferv^^rd) Relcad 

m 


jfe 1 file : / //liM27SS20bi1 /VRiilug /Maolj 

►1 

Products 

Pricing 

Press 

1# i;^:i//?ll1fe7g20fafti'Vi^rting/MaoT«iDh/j4pr; 

figure i 

the arroii 

When doing a rollover, 

' gives the user feedback. 



Image rollovers are handled by browsers that support 
JavaScript versions 1.1 and later, which includes Netscape 
Navigator versions 3 and above, Internet Explorer 4, and some 
versions of Internet Explorer 3- Listing 2 shows the code to create 
the image rollover effect. 


IdsttoS.?! Jtaiage rollovers give users feedback 

niivbar.htmi 

<Hm> 

<HEAD> 

<TITLE>Navbar</TITLE) 

<SCRIPT LAHGUAGE="JAVASCRIPT”) 

<!— Hide from old browsers 

If (document .images) ( 
productOn = new Image 
pricingOn “ new Image 
prefisOti ^ new Image 

productOff = new Image 
pricingOff = new Image 
pressOff = new Image 

productOn■ "products_on,gif" 
pricingOn. sre "pricing^on. gif” 

pressOn^sre = "press_on.gif" 

productOff. sre = '■produ.cts_of f , gif ” 
pricingOff .arc = ''pricing_off.gif” 
pressOff. arc = "pr-ess_off.gif" 

] 

else { 

productOn.sre = 
pricingOn.sre = ”” 
pressOn.src ” 

productOffHsre = 
pticlngOf f. sre “ 
pressOff.sre "" 

document.products = 
document, pricing = 
document.press “ "" 

1 

// Stop hiding from old browsers 
</SGRIPT> 

</HEAD> 

<B0DY BGCOLOR-WHITE) 

<A HREF=''products.htmr' 

onMouseOver-"products .src-productOri. sre" 
onHouseOut”“products.src“productOff.s rc"> 

<1MG SRC-"prDducts_Qff.gif' WIDTH="226'' HEIGHT“'*37" 

BORDER-"0" NAME="produt!ts"></A><BR) 

iA HREP-'''priQing .html” 

onMouseOver-^pricing.arc-pricingOn.sre" 
onHouseOut="pricing.srE:=pricingOff *src") 

<1MG SRC-'’pricing_o£f.gif" WIDTH-" 139" IIEIGHT“"30" 

BORDER-” 0" NAHE="prlclng‘'></A><BR> 

<A [lREF="press.htmi" 

t}nnousGOver-''press. sre-preEsOn. sre” 
onMouseOut-"press.src=pressOff.srt"> 

<IMG SRC=”press_aff.gif" WIDTH-"154" HEIGHT-"36" 

BORDER""0” NAME="press"></A> 

</BODY> 

</HTHL> 

In the <:HEAD> tag, we do our initializations. The first thing 
needed is to hide the JavaScript commands from browsers that 
are too old to understand JavaScript and too old to understand 
that theyVe supposed to igntjre text wathin tags they can’t handle, 
'fhis is done l>y starting a 1 irML comment, which is not closed 
until just before the closing script tag. Thi.s closing comment line 
works because it starts with a JavaScript comment symbol, which 
causes JavaScript to ignore it. Next, we check to see if the 
browser we’re using supports manipulation of image objects. If 
it doesn’t, then care must l)e taken to avoid giving the user errors. 
This is done by checking for the existence of document.images. If 
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it exists, we're able to do the rollover. If it doesn't, they have an 
old browser (JavaScript 1 0) or they have JavaScript turned off. 

The image rollover technique requires two versions of each 
image: one ”on" and one “off,” based on wJiether tlie cursor is 
or isn't on top of tfie image. So, for each of the three images in 
tlie window, we need to create 2 new image objects. We then 
assign an image URL to each of these image objects, by .setting 
tlieir src property, Tliis both enables the variables to lie 
referenced by name later wathin the body* and pre-loads the 
graphics into the browser cache, so that they appear virtually 
immediately w hen the cursor moves over the image. 

We also give each image on the page a name, by setting 
the NAME attribute of each within the <IMG> tag. While images 
can be referred to as documentimage[0] (for instance), it is more 
flexible & manageable to instead refer to document.products. 
This allows us to refer to the image by name later w^hen we 
want to manipulate it. 

If the user has a brow'ser that does not support image 
manipulation, we must initialize the same variables, so that using 
them later does not cause an error. Consequently, we set the src 
of each to the empty' string. In addition, w^e set tlirec other 
variables: document.products, document, pricing, and 

document.press. Older brow^sers don't understand that images can 
have names, so simply defining them here lets us use the objects 
in all browsers without an error. 

Within the body, we add event handlers to the link tags 
around the images, for both onMouseOver and onMouseOut. For 


example, when the products image first loads, it displays tlie 
image products_off.gif. When the cursor goes over the image, 
the src of products is reset to the src of the productOn image 
that we set in the header script. This displays the version of the 
image with an arrow. When the cursor is moved off the image 
area, the src of pr^iducts is reset to the src of the productOff 
image (set in the header script). 

If the browser does not support image manipulation, the 
onMouseOver event instead just sets the src of an empty siring to 
the src of another empty string, with no errors and no effect. 

The .secret to having this look good is proper preparation of 
the images, avoiding the two mo,st common mistakes. Firstly, the 
two images must be of identical sizes. When one replaces the 
other, the size of the image area doesn't change, even though 
the images themselves may be of different sizes. Instead, the 
browser will automatically resize the graphics for you, with 
unpredictable (and virtually always tinpleasant) results. Figure 4 
shows the six images actually tised in this example. The “off 
versions of the images, although they do not include the red 
arrow, have identical dimensions to their “on” versions. 
Secondly, the images must not liave transparent areas. In this 
case, if the white areas were transparent, the images would look 
fine upon first loading, and would also look fine when the 
cursor was moved over them. Rut, when the cursor w^as mc>ved 
off the Rrst time, the red arrow would continue to show^ through 
the transparent area of the “off’ image. 
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The best tool for text. 

BBEdit. The premier text & 
HTML Editor for the Mac OS® 


From those who know... 


“Eve been using BBEdit for about a month and now 
find it invaluable. It seems to offer just the tools 1 
need not only for HTML coding (which is what 
I bought it for), but also for writing and 
researchj which came as a surprise. 

As a devotee of light and flexible vs. 
bloated and unwieldy, Eve taken to 
using BBEdit for the daily grind 
of my writing chores. When 1 
get bored, 1 just turn to ‘grep' 
and toy with some complex 
search and replace expression! 

Thanks for your solid work.'* 


David Eddy Spker 
Assistant Director, 

Case Program 
John F. Kennedy 
School of Govermnent 
Harvard University 

'‘I use BBEdit every day and 
Tm continually blown away by 
the intelligent interface, the 
power user features like *gr^P ^ 
search and replace across multiple 
files, the syntax coloring, the FTP 
open Sc save, tlie configurability, 
Internet Config, everything. Every 
time I think of something Td like 
to see added to the program, 1 
discover that if s already there. 
You guys really thought of 
everything! When I use other 
programs, I find myself 
wishing for the featmes 
that BBEdit has.'* 

Chris Varasy 
US Web/Dream Media 



<http: //web. barebones. com/ > 
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Bare Bones Software, Inc. 

RO, Box KMS. Bedfordn MA 0173€ • main 781-687-0700 • fax 7S1-687-0711 


BBEdit is a trademark of Bare Bones Software, be. 'll Doesn't Suck" is a registered trademark of Bare Bones Software^ Inc. 0 1998 Bare Bones Software, be. AQ rights reservaJ. 
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I Products! 

l►Productil 

Pricing 


► Pricing 


Press 

!► Press 



Figure 4 There are acluaily 6 images; 1 each 
with and untboui the arrow. 

JavaScript Navigation 

Another way of improving the user interface of a web site 
is to improve its navigation. One technique of doing this is to 
create a jumping popup menu, such as the ones on Apple's 
DevWorld site. Tliis example requires little actual scripting, 
outside of handling the onChange event from the popup 
menu, combined with some knowledge of how JavaScript 
interacts walh HTML. 

The HTML <SELECT> is used to create the popup menu 
shown in Figure 5- It has four options: ""Pick an area,” 
“Products/ “Pricing/ and “Press.” Choosing an option triggers 
the onChange event, which evaluates the line of JavaScript 
showm in Listing 3. 



Figure 5* This popup menu sends you to a new page instantly. 


Tes UfTiHa rJt 

Your Totol Bug Tracking Solution »i- 


If you're a developer^ you've got to get TestTrack. 
Your hugs will hate you for it!" Cooi hot of rJ^e Day 


Discover the tool today's top software developers are using to improve the 
quality of their Mocintosh and Windows opplicotions— TestTrack. 

• track bugs, feolure requests, picbleim, q„|„ 5 j 2 + for $149 each! 

cuslom^ mfofmdlbfi, and more. , iioooioq/jn-t 

. New! t muil uotilkaHons-SMrPaad MAPI. To order (oll 888-683-6456 

• New! ImpofI bugs via e-moil oulomolica lly. OF 513 " 683“64 5 6 

• ProdiKe toncise reports. 

• Multiple users, full se<uiitHi^il< eogioeers, 
lesiers, monogers, even teth wrUers. 

■ New! Improved help desk support. 

■ New! Deferred defect numbering, exlemul 
etlochmenf storoge, customer bug histories, 
end much, much, more. 

■ Automatically route bugs to teoni members. 

• Track the history of eodr bug. 

■ Serve time and improve tech support by 
giving Sola Bug, TssiTrock's ^und-okme bug 
reporter, to your customers. 



Download our demo today! 
http; //wwwpseapiiie-com 


sales@seopine.com 

http://www.seapine.(om 



Listing 5: Instant navigation a popup men u 

<Hm> 

<HEAD> 

<TITLE>Pop-up Meiiu</TITLE> 

</EEAD> 

<B0DY BGC0L0R-VHITE> 

<P)Vhere do you vant to ga?</P> 

<F0RM> 

<SELECT 


pripup.htrnJ 


onChange=”if (this.selectedlndex y 0 ) 
window. locatioii*hi:ef=This. options [this * selsctedindex]. value'O 
< 0 PTI 0 K>Pick an area 
< 0 PTI 0 N VALUE=" products. html>Product s 
<OPTION VALUE-”pricing.html")Pricing 
<OPTIOK VALUE-”press.htnLL“>PTess 
</SELECT> 

</F0RM> 

</body> 

</HTML) 


Firstly, we check the value of selected Index. This is a 
number between 0 and 3^ depending on which option was 
chosen. If the option chosen was the first (“Pick an area”), we 
don't w^ant to do anything, so we only do anydiing if 
this.selectedindex is greater than zero. 

Otherwise, changing the value of windowJocation.href will 
force the browser to load a new page. This example uses the 
HTML VALUE attribute of <OPTION> to store the new page that 
we want to [unip to. Each of these values can be referenced by 
JavaScript via the value property of the options array. When the 
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user choose!^ an optioHj JavaScript finds the new page by 
referencing into the options array witli die setectedtndex, and 
using its value as the location of the page. 

One of the major benefits of this style of handling popup 
menus is that changes to the menu can be made with no 
knowledge of JavaScript necessary. In fact, once the onChange 
handler has been added, die page can then be modified by 
WYSIWYG editors with no loss in functionality, so long as the 
VALUE attributes are maintained correctly. 

There's one smaU trick here, if you decide to change the 
popup so that the first option on the menu is a valid location, the 
user won’t be able to ever get there. The event handled is 
onChange, and there's no way for a user to cause it to be 
triggered when choosing the default option. 


Flow Control 

Like most programming languages, JavaScTipt has die expected 
ways of controlling die flow of commands. Lisdng 4 and Figure 6 
demonstrate funcdons, loops, and if stataneoLs in JavaSaipt, 


Listing 4; ControUing flow in JavaScript 

factorialliiml 

<HTML> 

<HMD> 

<TITLE>Factorial</TITLE> 

<SCR1PT LANGUAGE-”JAVASCRIPT"> 

<!— Hide script from old browsers 

function ahowFactotial(theEntty) i 
document.myFo rm > result.value - 
calcFactorial[theEntry.value) 

] 

fimction calcFactorial(inVal) f 

if (isNaN{inVal)) // bNaui - h Not a Number 

return{"Not a number") 

atartVal - evaKinVal) // eval turns a string into a number 

if tstartVal < 0 I| stariVal !- Math.floortstartVal)) 
return (“Invaliti number") 

endVal = 1 

for (i“l: i<“startVal: i++) [ 
endVal = endVal * 1 

1 

return(endVal} 


// End hiding script fr(?m old browsers —> 

</SCRIPT> 

</HEAD> 

(BODY BGCOLOR-WHITE) 

<H3>The factorial of 
(FORM NAME-^myForm"> 

(INPUT TYPE=TEXT SIZE=3 

onChange"*’javascript; showFactorial {this) "> is 
(INPUT TYPE^EXT NAME-^reault”) 

(/FORM) 

(/H3> 

(/BODY) 

(/HTML) 


In this example, the user enters a number in the first field. 
Changing this field passes control to the onChange event handler, 
which calls the showFactorfal() function, with the entry field as its 
parameter. The showFactonal{) function calls the calcFactorial() 


function, passing it the value of the entry field. 

The caicFactorialO function returns either an error message 
(if not a number, less than xero, or not an integer) or Ll:te factorial 
to ils caller. When control passes back to show Factorial (), the 
result is put into the result field in the browser window. 



Figure (x Entering a number displays its factonal. 
CONCXUSION 

Another popular use of JavaScript is form validation, which 
will tell the user if the form they’ve submitted is valid without 
having the overhead of connecting to a Web server. This 
technique gives the user the impression of speedy Web access, 
when they haven’t accessed your server at all. 

JavaScript is growing in popularity, due to many factors, 
including its ease of learning, the growing share of JavaScript- 
enabled browsers, and the large number of resources available to 
novices. With Dynamic HTML on the horizon, JavaScript will 
become more important and more prevalent in the future. 
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JAVATECH 


by Ken Ryall 


Writing Java on the Mac for All Platforms 


Here are several of the 
pitfalls of writing multi¬ 
platform Java code 


It's easier than ever to write your Java 
code on the Mac for multi-platfomi use. 
You can write once on die Mac, ilien run 
anywhere, but you'll learn a lot about the 
way Java is implemented on each platform 
along the way. 

Ironically^ the Mac is a gotxl Pure Java 
starting pfiint. If it works on the Mac it 
should work on other Java platfoims. 
However, there are differences, often 
subtle ones. These differences betw^een 
Java on the Mac and Java on other 
platfomis are often refleaions of each 
underlying operating system. In addition to 
differences in how each virtual machine is 
implemented, other potential problem 
areas include threads, networking, file 
systems, and user interface elements. 

Java THREiVOS 

Unlike most other Java platforms, 
Macintosh Java uses cooperative threads 
rather than preemptive ones. Java's 
preemptive threads are simulated on the 
Mac by a cooperative VM. It will yield time 
to other Java threads and to the Mac OS 
when a Java thread's state becomes “not 
runnable”. This happens when a thread is 
waiting for I/O to complete, is put to sleep, 
is suspended and in a few odier cases. 


This difference in underlying thread implementation means 
you should avoid making assumptions about thread scheduling, 
priority or timing beyond what is specified in the Java API. 
Threads of equal priority will get very different treatment 
depending on the VM. 

Also, be aware of wliat kind of code wiE let the VM run 
other threads. For example, when opening a socket and listening 
for connection requests, the VM will run other tlireads wMe 
wailing for Socket,accept() to return a connected socket. 

// bind a socket on port 

ServerSocket mySocket ’ nev ServerSocket(3000): 

// listen for connection requests 

Socket clientSocket = inySocket.accept(): 

However, the loop below contains no calls to I/O and may 
block other threads on the Mac. On platforms such as Windows 
NT other threads would still be allowed to run. 

int count = 5000000 j //busy pointless loop 
while (count > 0) 

count “; //While in loap VM may run other threads, maybe not. 

If you have CPU intensive loops like this you'll need to caU 
Thread.yield0 to allow die VM to service otlier threads. 

If your application uses tlireads in more than a casual way 
you 11 need to experiment to find best cross-platfonn 
performance. For example, here is a thread with an idle loop that 
checks tilings now and again and shares time with other tlireads 
by catling Thread.yi 0 ld(): 

public void run() 

[ 

boolean keepGoing = true; 
while (keepGoijig) 

1 

if do some stitfE.. 

// yield time to other threads 
yield{): 

I 

J 


Ken Ryall <kryaD©outer.net> has been developing on the Mac since 1985 and is currently working on the debugger at 
Metrowerks in Austin, TX. When not at work he's usually out flying or at home trying to convince his border terrier not to 
chew up the ISDN line again. 
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Calling Thread.yieldO while looping seems to work fine on 
the Mac. However, on Windows NT constantly calling 
Thread.yieldO will leave the VM hogging as much of the CPU time 
as it can get. Putting the thread to sleep for short periods is a 
better cross platform solution. 

public void rtinO 
{ 

boolean keepGoing ^ true; 
while(keepGoing) 

[ 

// do st>ine stuff.,, 

// sleep Ibr ten seconds, this will let other threads run 

sleep(1000 * 10); 

) 

1 

Developing on the Mac will also make you keep your use 
of threads simple: more than a few running Java tlireads hurts 
performance more than on other platforms. 

Networking 

The netw^ork classes in the java.net package use whatever 
native TCP/IP services the host macliine offers. This means your 
Java networking code will pick up any eccentricities in ilie native 
libraries. A common complaint of cross platform Java developers is 
that their network sockeLs work with one platform/VM 
combination but not another Results can even vary^ from machine 
to machine and network to network. 

Networking problems can include socket/stream 
combinations that don't return all the data until asked multiple 
Limes. Other sockets don’t seem to want to send their data until 
closed, even after being flushed. 

In one case, my server was returning some data by writing 
to a stream and closing the socket, lliis worked fine on Mac OS 
and Windows NT but sent empty packets from some Windows 95 
machines on some networks. The ftx? Insert a tiny delay between 
flushing die stream and closing the socket. How did I find it? 
Desperate trial and error 

Most of these problems are related to bugs in the various 
VMS, whose intensive revision has produced evolving levels of 
functionality and stabilit>\ Reviewing some of the many java 
networking examples can help identify problems and 
workarounds. In particular, the web serv'er Jigsaw 
<http://www.w3,org/Jig5aw/> is a good example of a complex multi¬ 
threaded application, jigsaw works cross-pladbrm and has 
iindeigone more extensive testing than most examples available. 

Unix Subtleties 

java includes cross-platform classes for handling files and tries 
to present a platform neutral APf but it helps to remember that the 
whole thing came from die Unix world. Nowhere is this more 
apparent than in the way tlie File cla4ss works. In fact, the java File 
class probably creates more cross-platform problems than any 
other because of its assumptions about the native file system. 

To begin with, file names can be longer tiian the 31 chiiracters 
dial the current Mac file system allows. ( HFS+ supports longer file 
names internally, but there isn't an API to access them yet.) Lols of 
Java sample code that lias never seen a Mac has files like: 


""MyReailyCoolJavaThreadedNctworkingCiass.lava". VMs on the Mac 
liave no problem witli longer names in JAR files, you just can't have 
the original source files. Tliis can lx; a problem if you're working 
witli developers on other platforms who like very long file names. 
Until die long filenames in HFS+ are accessible, you’ll eitlier have to 
get diem to be less verbose, or build their work into libraries so you 
won’t liave to work with their source files direedy. 

Various VMs also make different assumptions about case- 
sensitivit>" of file names and allowable characters in file names. 
Remember that most virtual machines liegan life as Unix source cxxle 
and may lx; incompletely ported to dieir new^ native file systems. 

In Java, files are specified by path name, but trying to build 
a path name in a platfomi neutral fasliioo is difficult because VMs 
return inconsistent and conflicting values for descriptions of 
parent directories and separator characters. Making a path name 
that will work with one VM isn't too difficult, making one that is 
cross platform friendly is often much more difficult, 

Cross platform Java developers are frustrated by this and 
usually try to simplify file specification so they don’t have to 
build path names. If you do, be sure to use File,pathSeparator() 
instead of hard coding a path separator. Also, examine your file 
naming schemes and remove characters that aren’t allowed on 
any of your target platforms. 

User Interface 

Differences in platform user interface mean that a some of 
your interface may not come out looking like you intended. 
Fortunately you can often tweek placements, sizes etc. in a 
platform neutral way, you'll just need to try out the results on 
each of your target platforms as you go. Be sure to use layout 
managers, not absolute locations, to place items and avoid 
assumptions about things like font metrics and screen size. 

Also, every VM on every platform has its own AWT bugs and 
display glitches, and these change as the VMs are revised. Most 
of these you'll be able to see and work around. 

Don't forget that while you can write a lot of pure java cross 
platfomi code, you can still detennine what platform is running 
your java code and act accordingly. 

String whichOS = System.getProperty {'‘os.name"); 

If [whinhOS.contains[“Mac")) 

( 

// do mao specific siufl’ here 
I 


Testing 

Testing cross-platform java applications is simple if tedious; 
you just have to tr)^ it with every VM/platform combination you 
hope to use it with. In particular, exercise the features that use 
networking, tlueads, and deal with files. Check the UI carefully 
for missing elements and overlapping items. 

Some of the Java tools are less mature than their C++ 
equivalents so there aren’t as many debuggers and other testing 
utilities to work with. Of counie, there is the old fashioned way: 
System.out.println(). Finding out how things work with virtual 
machine X on platform Y is mostly a matter of trial and error. 
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It’s also helpful to find other developens who are sharing 
their experiences with the VMs you are targeting. For Mac VMs 
a good place to start is the MRJ mailing list at 
<http://wwvvJists.apple.conn/rTirj,html> and there is also the 
Metrowerks newsgroup at <news://news.metrowerks,com/comp.sy5. 
rnac.programmer,codewamor>. 


Installing 

Java’s platform independence quickly vanishes when its 
time to install and launch your application. Each platform has iLs 
own VM installation and method for launching a Java application. 
If you want to Icxik just like any otlier professional application 
you'll need to build an installer for each platform that includes a 
VM and puts all your pieces where you w^ant them: maybe tlie 
“Startup Items’^ folder on the Mac or as a service on NT. 

This can be complex and tough tf] maintain, but is no wcjrse 
than installing a complex cross platform C++ application. A more 
Java-oriented solution is InsrallAnywhere, available from Zero G 
Software <http://www.ZeroG.com>. InstallAnywhere is written in 
Java and lets you build an single universal installer that will work 
on any platform, including setting the runtime environment, and 
installing a VM. 


Write Once„. 

Developing cross platform Java code on the Mac really 
works if yOLill keep a few tilings in mind. You can write once 
and run anywhere as long as you test and make a few 
adjustments. Finding solution.s to cross-platform problems will 
often reveal problem code that slipped by the original compiler 
or VM and needs to be reworked anyway. If you’ll willing to deal 
with a few platform-specific problems and a wider variety of VM 
behavior, you’ll have the satisfaction of developing your code on 
the Mac, and the ability to drop the result on an NT machine and 
find that it all just works. D 


Want to suggest an 
article for the 
magazine? 

Send your suggestion to 

<mailtojeditorial@mactech.com> 



A 


- . f 

A+elational database for 

product ifevdtoperst 


hanc 


X 


true relationalAJatabase functionality 
art/and a leg? Introducing 
dtF/SOL.'^^^^>B^'iefM^lp proven, truly relational. 
Why now that SQL 

tedi^ltig^ 

/oT 

£^Sh^t1iQlg re 9 Pr|!| and let dt. 
i|:^ur database wOrriil^ 

K^Mrfa+fuafufBs 

handling ♦ aummajic locks v 

♦ advanced R4 redbvcQ' 
witfi full trStmcffiaft ^ ^ getee a^asswords. acc^»>. ^ 
r^ts, encrypied'databas@WE^jS^j^,^^u^^^ 
and server versions av^lable ♦queiyo'ptHtttaaoon.^ 
'and load balancing ♦ smafbRiemory footprint 

♦ C/C-H- interface, ODBC driVsTj EOF-Adapter, 
HyperCard, Supcrcard, and other irl^rfaces 


\ 



Cros 

♦ Mac OS ♦ 

♦ Windows 95/NT ♦ 05 

♦ several UNIX flavors^^yie 
>1PX ♦- ls®TB^eS"*^ple 


Linux ♦ TCP/IP 


Great 



pr - 


h 

L * 



L 

_ 



MafOS 


AppleTalk ♦ Named Pipes 

terms 

♦ Use for free during development 
* free shipping license for non¬ 
commercial use ♦ low rates for 
commercial products 
[ ♦ Special agreements for 
^ CD-ROM apps available! 

Go check our WEB site. 
http://www.5iah.de 


May 1998 • MalTech 


Wriung Java on the Mac for Au, Platforms 


37 


















by Michael McLaughlin, McLean, VA 


Scientific Programming in PowerPlant 


PowerPlant provides a 
simple application shell ivith 
which we can do serious 
number crunching, and stiU 
have a user-friendfy, 
Macintosh interface 


An Akray of Excuses 
can da eveiything I need in C.** 

Does that sound familiar? I hear it a 
lot, not just with reference to C but also to 
Fortran and, once, to Basic! Scientists and 
engineers, in particular, often tend to 
view a visit to the compiler much as they 
would a trip to the dentist — a rueful 
necessity, best done as quickly and 
painlessly as possible. The result, 
unfortunately, is seldom a nice, friendly 
application with a pleasing graphical user 
interface (GUI) but, rather, HelloWorld 
plus footnotes, usually accompanied by 
lots of global variables, predefined arrays, 
and nary a pointer in sight. 

The standard excuse is that they are 
in a hurry and, anyhow, C++ is useful 
only For software that manipulates 
objects (whatever they are) and is totally 
inappropriate for the sort of 
mathematical calisthenics that cause 
physicists, astronomers, and others to 
chew up hours of clock cycles in search 
of a single niimben 


There are several reasons why computations can last for 
hours. They might involve a laige number of mini-problems, or 
they might address a single problem comprised of many steps, In 
some cases, the solution could require iteration to convergence, 
and this might take a while. The example described below 
contains all of these elements. However, its size is small enough 
for demonstration witliout compromising the intended objectives. 

Tliis article has tliree objectives: to demonstrate that C++ not 
only is appropriate but, indeed, advantageous when it comes to 
writing mathematical .software; to show tliat PowerPlant is an 
easy way to develop Macintosh applications rapidly; finally, to 
pre>sent a simple template, generally suitable for adaptation to 
CPU-intensive applications, 

A SOENTinc Problem 

We begin with the Solar System at midnight (GMT) on the 
Fourth of July, L976. We are given the Cartesian coordinates for 
all of the planets and the Sun, along with some additional data 
to lie discussed lielow. The problem is to use Newton's Law of 
Gravitation and his Second Law of motion to predict the 
configuration of the Solar System 365 days later, keeping the 
system center-of-mass as a constant oiigin. 

Given Newton’s Laws, this task appears straightforward. It 
consists of a set of 27 second-order differential equations (three 
coordinates per planet), each of which has the following fonn: 



where q^ is a coordinate of body[n], t is time, mj is the mass 
of body I j], qj Ls the radial distance between body[i] and body[j), 
and G is the grtivitational constant. Time is measured in days and 
distance in astronomical units (AU), (I AU is, approximately, the 
average distance between the Earth and the Sun.) This 
formulation ignores several important factors, namely. Special 


Michael McLaughlin <mpmcl@mitre.org>, a former chemistry professor and Peace Corps volunteer, currently does RAD fc>r 
future Air Traffic Control systems. He has been programming computers since 1965 but has long since forsaken Fortran, PLI, 
and Lisp in favor of C++ and assembly. 
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and General Relativity, nonsphericiry of the planets, and a 
handful of asteroids that perturb the orbit of Mars significantly, 
but these all are secondary effects, complicated though they are. 

Solving this problem requires integrating all 27 differential 
equations over successive time intervals, h, until tfie target time 
is reached. Here, we shall use Numerov's method, in 

Qk+i = 2 q,,-qk_i + -^[Pk+i + lOFk + Fk-i) + R 

where R is the error for this coordinate for interval k. Since 
F(q)]t +1 appears on the right-hand side of this equation, even 
though is obviously unknown, iteration to convergence 
will be needed. 

With every^ iteration, tlie center-of-mass constraint detennines 
the coordinates of the Sun. For each coordinate, we compute 

“ mi ill 

Numerov’s method is not meant to achieve world<lass 
accuracy. In fact, its most redeeming quality is its brevity. Tliis 
teclmique requires two very accurate starling configurations as 
well as values for the masses of the 10 bodies (as is customary, 
Eanh and Moon are combined). These values are listed in the 
data file (fnit.dat) accompanying the source code package 
available from <ftp://ftpmactech.com/src/>. 

And now, it^s time to start coding. 
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Fax; +49 (40) 30636333 
sales @ pri mebase .Cfom 


Download Now'! 

WWW. pri m e base .co m 


Building the Application 

What fallows assumes familiarity with CodeWarrior and 
Constructor (or, at least, ResEdit). Knowledge of C++ is not 
assumed although a passing acquaintance with its syntax will he 
helpful. This example was compiled using CW Pro 2. Earlier 
versions should require few, if any^ changes. 

Start by creating a new project, named SolarSys,p, from the 
Basic PowerPlant PPC (or 68K) stationery. This ensures that it gets 
the requisite PP files and libraries, it also means that almost all 
of the project headers will be precompiled. Change the names of 
the project and target to SolarSys. Select Run to compile the PP 
files and to ascertain that everything works. 

The Main Routine 

This default app does not do exactly what we want, so we 
shall have to modify it a little bit. Open the file CPPStarterApp.h 
and replace CFPStarterApp with SolarSysApp everywhere. Then, 
after the #include, add the line 

//include “Flags.b” 

Just before the protected block, add the line 
Uint32 Flags: 

Save As SolarSysApp.h and youTe done. Now, for the source file. 

In CPPStarterApp.cp, replace CFPStarterApp with 
SolarSysApp everywhere, then add 

//include "CSetup*h'' 


Delete the sample ResIDT. 

We are going to make our own custom dialog box, which 
must be registered.” Therefore, change the constructor to read 

RegisterAllPPClasses () : 

// llegi^ter my ppob dasses 

URegistrar r :ReglsterClaGs(CSettip: :claas_ID, 

(ClassCreatorFunc) CSetup::CreateSetupStream): 

Modify cmd_New, in ObeyCommand (shown below), to get 
our own dialog box (that we haven’t created yet ) imd to 
initialize the Flags. Don’t worry that Setup is only a local variable; 
PowerPlant maintains internal links between the dialog box and 
its SuperCommander, the application, 

case cnid_New; 

LDialogBox *Setup: 

Setup = (LDialogBox*) 

LWindow::CreateWindov{rRidL_Setup. this); 

Flags = WORKING: 
break: 


Finally, modify cmd_New in FindCommandStaius as follows: 
case cmd_New: 

outEnabled ^ (Flags & WORRIUG) ? false : true: 
break: 

Believe it or not, thafs all there Is, Just Save As SolarSysApp.cp, 
Don’t try to compile yet; some pieces still are missing. 
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Custom Stuff 

Classical procedural languages, like C, are built around 
verbs. “Do this. Then, do that. If this happens, go there." and so 
on. Object-oriented languages, such as C++, are built around 
nouns. They talk about 'ifungs" and the functionalit}^ of those 
things. When written properly, a C++ program solves a problem 
using the same words that are found in the statement of the 
problem. In this case, we are going to invent fcjur new nouns 
(classes) tliac are especially suitable to our specific problem. 
They are CVector, CMatrix, CSetup, and CSolver, the “C" 
indicating a class that we devise, in contrast to those, such as 
LWindow and IJRegistrar, w^hkh come with system libraries and 
utilities, respectively. Any specific instance of a class that we 
might declare is called an ‘"object.” Were this article a lot longer, 
we could elaborate our design by defining CPlanet, CForce, ere. 

This discussion is limited to tlie main features of tliese four 
classes. All of the code Ls included in die code listings, except for 
SolarSysApp.cp, which is nearly unchanged from the stationery'. As 
you examine the various (iinction.s, you may think of enhancements 
and/or ways to make them better. A lot of obvious features have 
been deliberately left out to encourage you to experiment. 

CVector and CMatrix 

By far, the most usefiil classes in this project are CVector 
and CMatrix, The words, “Vector” and “Matrix” do not appear in 
die statement of the problem but they are so ubiquitous in 
mathematical computing that they deserve to be separate 
classes. If you write a lot of such programs in C and this is your 
initial entry into the world of C++, dien it’s likely that these two 
classes alone are worth the price of admission. You may never 
have to callocO again! 

CVector and CMatrix constitute the module StmpleArrays. 
They are just that — a one-fril! implementation of one and twiy 
dimensional arrays, the one frill being runtime array-btumds 
checking. Much more elaborate implementations can be found at 
several websites. A good starting point is the Object-Oriented 
Numerics Page at <http://monet.uwaterloo,ca/oon/>. 

'fhese two classes are template classes so they can be used 
to declare arrays of anything, even themselves! Using them is 
trivial. For instance, 

CYector^dDuble) facitDr(Sun. Pluto): 

declares a vector of doubles widi indices trom Sun to Pluto 
(enumenited elsewhere) while 

GMatrix<ciouble> initial_etate: 

declares a matrix of doubles w'itli row.s and columns having 
the default indices 1 to 10. Of course, all arrays are resizable, 
.such as 

i]iitial_state. reside (Sun, Pluto, X, 2] \ 

Arrays of higher dimension are also easy to construct. Here 
are two different ways to declare a three-dimensional matrix, the 
second making copies of two existing matrices. 


CVectorC CMatrix<double> > state Cl, 1): 

CMatrix<double> trial_state[2] 

tstate[current], state[next]1; 

There are several examples of these classes scattered 
throughout this project and their udlity should be apparent. 

One caudon: SimpleArrays.cp must be ^included in one of 
the other source Mes, not added lo the project. This is a 
consequence of the template code. More often, template code is 
simply merged into one huge, typically unreadable, header file 
instead of being placed in its own source file. 

The remaining source files, for CSolver, CSolver_I_0, and 
CSetup must all be added to the project. 

CSofver 

Even if you go to the trouble of making your own event 
loop, chances are that it will not suffice for a problem like this 
one. In CPU-intensive tasks, typically your code launches into a 
for or while loop containing the essential calculations and your 
computer is tlien frozen out until tliat kx>p finishes. This could 
take hours or, even, days. 

To alleviate this problem and create an application that 
behaves reast)nably, we introduce the class CSolven This class 
inherits Functionality from both ITeriodicai and LBroadcasier. 

Here is the beginning of die CSolver definition: 

// CSotvCT is anUdfer” LPtriodical which bmadcasts status messages, 

class CSolver : public IPerlodical, public LBroadcaster [ 

public’ 

//These members are generic to alJ solvers: 

CSolver(LLlstener ’setup); 
virtual -“GSoIverC) [ ]: 

void SpendTime(const EventRecord iinEvt); 

void doInputO : 

void doOutput(int mode = 0); 

private; 

void Initialize 0 : // resixe amiys, etc. 

VO id one Cy c 1 e 0 i // called by SpendTimeO 
Uint32 'flags; 

LPeriodica! functionality allow.s the MainEventLoopO built 
into LApplication to perform as you would expect. Among other 
things, this means letting you Quit whenever you want to, not just 
when your computation Is finished. The trick is to make Solver 
(the CSolver object) an “idler” periodical by railing its method 
StartIdlingO. Then, its virtual function SpendTimeO will not be 
called until the application's event queue is empty. (Here, there is 
also a READY flag for extra protection.) SpendTimeO, in turn, will 
trigger one cycle of the computation. Therefore, all we have to do 
is to break up our task into little pieces, short enough to be 
completed l:>efore returning to MainEventLoopO. This is usually 
easy to do since, as noted above, long computations are almost 
alway.s formed frt^m a large number of smaller computations. 

Solver terminates each cycle by l>roadcasting one of three 
status messages. These indicate that a phase of tlie computation 
has finished, or that the integrator diverged, or tliat there is more 
work to be done. 

The I/O functions are generic components but tlieir details 
are task-specific. These two methods could be a lot fancier, for 
instance, with standard file dialogs instead of assuming a default 
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folder. Even so, note how much simpler and cleaner they look 
compared to tlieir usual C counterparts, I’iiis code includes the 
large, non-PP header <fstream>. In general tliere could be several 
I/O functions requiring this header. Combining tliem in a separate 
module is one way to keep the size of a project to a minimum. 

Tlie rest of CSoiver is also specific to out task. Most of this will 
become dearer once ail of the project’s components are in place. 

CSetup 

We are now' ready for the final piece. This is the Setup/Status 
dialog, a customized dialog box which will function as our GUI 
and as the “Commander/Listener” for Solver In a sense, Solver 
belongs to Setup just as Setup belongs to SolarSysApp, It is, 
therefore, to Setup that Solver sends its messages. This 
partitioning of responsibility may not sound like much but it is, 
in fact, crucial to the simplification of complex code and is one 
of the key characteristLcs of object-oriented programming. 

We shall first de.scribe the main features of CSetup and, then, 
say a few words about building die dialog using Construaor. 

In this project, the principal differences between CSetup and 
the default LDialogBox, from which it inherits, are found in the 
methods FinishCreateSelffi and ListenToMessage(). To 
FinishCreateSeif(), we add some code to tell the dialog box diat 
it has more than just the OK and Cancel buttoas. We also grab a 
pointer to the application's Flags variable. This pointer Ls later 
passed to Solver Thus, there is only a single Flags variable, each 
bit of which is a separate flag. {See Flags.hT 

ListenToMessageO does all the real work. Whenever you 
click in Seaip, you send a message. As Figure 1 shows, there are 
buttons and checkboxes to click and editfields in which to type, 
(Your Appearance may differ.) The editfield labeled “Steps to Go” 
doubles as a progress indicator during the integration. 


. - Setup/Status = 

Bodies 

At (days! 

E Sun 

E tJupiter 


El Mercury 

E Saturn Stens to Go 

E Uenus 

E liranus 

365 

! E 

E Neptune Renort euery 

E Nars 

E Pluto 

30 




[ Cancel ] 


II "■< ]| 





figure L Setup/Status Dialog. 

In addition to messages received from the dialog box, Setup 
listens for one of the tliree messages sent by Solver and takes the 
appropriate action. Altogether, five messages have been defined 
and/or customized. (See CSetup.cp.) 

In the ListenToMessageO function, DONEl and PHASE2 refer 
to the first and second phases of the integration. As the figure 
indicates, you can enter any timestep, delta_t, in tlie topmost 
editfield. However, the datafile read in at tlie start provides only 
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u very tiny step, dt = 0.001 days. In the first phase of the 
iiiregration, the integrator is repeatedly called, using h = dt, until 
the planetary configuration at your chosen value of deltaj is 
reached. The default for delta_t is 1 day. I’herefore, it takes a 
thousand cycles just to finish this first step. You'll need a bit of 
patience! While you are waiting, you can figure out how to add 
a progress indicator for Oils first phase. PHASE2 refers to the 
primary time interv’al, specified in the dialog box. By default, this 
contains 365 steps/cycies, with the progress indicator counting 
down by tens. The planetary ctinfiguration is appended to file 
SolarSys.out every 30 days, 

Bimj)iNG THE SEirn^WiNDOw Resource 

Our custom dialog box, created by cmd_N^w, is built using 
the resource editor Constructor. Constructor ailow^s you to create 
GUI elements for PowerPlant applications without any coding 
whatsoever. Not only that, these resources may be subsequently 
edited, e.g. translated into Chinese, without requiring any access 
to the source code. 

Open tlie file PPStarterResources.ppob and delete the window 
tilled <replace me>. Now, with Windows & Views selected, create 
a New Layout Resource of Kind IDialogBox, Name it Setup and 
give it a Resource ID of 1000, (The latter constant, and all the re.st 
that we will need, are defined in the file CSetup.h.) Double click 
the Setup dialog that appears and modify its l^roperly^ Inspector 
window as follows: Change the Class ID to our custom ID, SetU 
(case-sensitive). Position the top at 60 and the left at 20. Change 
tile height to 180 and tlie Window proc to Moveable modal, with 
a tide of Setup/Status. Last, chiinge the Default (OK) and Cancel 
button IDs to 1001 and 1002, respectively. 

Save As SolarSysApp.ppob and exit Constructor, At this point, 
the project should Run without error 

Finish the project by reopening the .ppob file and inserting 
the remaining dialog items: 

Drag-and-drop the two LStd Buttons (pbut) from the Controls 
submenu in the Catalog window. Enter Pane IDs of 100] and 
KX)2 along with the OK and Cancel titles. Likewise, change their 
Value Messages to msg_OK and msg_Cancel. 

The rest of the items are in the Panes submenu, beginning 
with the ten checkboxes (cbox). Add the appropriate titles 
and be sure to disable the cbox for the Sun. (See Figure 1.) 
Make all of them Initially Checked, and give them the Pane 
IDs listed in CSetup.h. 

Similarly, insert the three LEditField (edit) iteins with their 
corresponding IDs. Enter the initial text and, if you wish, the 
maximum (number oD characters. For the two integer editfields, 
set the key filter to Integer. 

Finally, add the four LCaption (capt, fomierly, stat'l'ext) 
items. Since these are never referenced, their default IDs are 
adequate. If you want to matdi the styles in Figure 1, create a 
new Text Traits resource for a centered and underlined 
SystemFoni and use it for the captions. 

Solar System, 4 July 1977 

That's it! If everything has gone according to plan, the 


application should Iriehave just like any normal Macintosh app, 
Double-click the icon and you should see the new dialog box. 
Cancel, and the app should quit, just as 
CSetup::ListenToMessage() says it should. 

if you click OK or hit Return instead, then, about 80 seconds 
later (depending upon the speed of your computer), there will be 
a double beep and the progress indicator will start to count down 
to zero. Half a minute later, tlic application will beep and quit. 

Ideally, the output file should contain the exact coordinates 
for the Sun and planets on 7/4/97 but, as you might expect, there 
will be some error. The correct answers are given in Table L 


Table 1. Solar System Coordinates (4 Ju ly 1997) 


Body 

X 

Y 

Z 

DJ^ from Sun 

Sun 

*lSm7Te-03 

-3.B3a760e-<l3 

-i.7B4555e-03 


Manci/jy 

-l7047?Se-OJ 

+2.29B152e-01 

*l4W340e-0l 

3.237438e^t 


-^J4mse-0i 


-1.5043$4e-0t 

7.277m^0i 

Eaflft.^foon 

+2 172080e-01 

-9J55892e-0} 

-3.370636e-Ql 


iWara 

+l355Q82e^ 


+}J277J2e-0l 

l4J0JB5e^ 

Jupiter 

-^lW2357e+W 

^.544504e+m 

^t3W275eiW 

S.07i694e^ 

Sstum 

-^.944500e+^0 

*5.4J7624e+00 

+2.535628e^Q 


Umnm 

-t.40447Se^t 

-1J2m3e+0i 

-4.7t3703e+00 

r.S5SOS7e-h0r 

Neptune 

-7.7Q762Be*00 

-2JU94te*Qt 

-l.093293e^t 

3.0289}Oe+Ol 

Pfm 

-2.B29S3Se*Of 

■9.9U559e+OQ 

i^5,43275te*09 

3.0472926*0} 


Most of planetary motion occurs in the X,Y plane so most 
of the error occurs there as well. Also, planets that move faster 
will have more error than those that move more slowly. Were 
this a serious attempt to get an accurate answer, we would have 
made die time step adaptive and specific to each body- 
coordinate pair, getting smaller as error estimates increased, 
and vice versa. We also would have used a much more accurate 
technique, with adaptive order and, perhaps, even adaptive 
degree in our integration. 

You can experiment with all of the options given in the 
Serup/Status dialog. It’s fun to see what happens when planets 
are ignored (by unchecking them) or when step sizes change. 

...or, perhaps, you had an idea of your own that you would 
like to try? 

SimpleAmys.h 

//A very simple pair of template classes for vectors and matrices 

//pragma once 

teniplate<ciasfl Type) 
class CVector I 
public; 

// Constructors 
CVector0■ 

CVector(long firfitlndex. long lastindex); 

CVector(const CVector<Type> ^origlnall; 

// Destructor 
''CVectorO : 

// Delete the cjld vector and make a new one. 

void resize(long ficstindex. long lastindex): 

// Subscript implementation with arm>’bounds check 

Type ^operator[] (long index); 

const Type fiioperator[] (long index) const: 

// Basic accessors 

long getFirstlndexO I return lower;); 
long getLastlndexO [return upper:1: 
unsigned long size () (return Nelements;]; 
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private: 

Type *head; 

Linsig.ned. lotigNelements; 
lang upper, lower ; 

) ; 

template <elass: Type) 
class CMatrix f 
public: 

// Conatmciors 
CMatrixO ; 

CMatrixdong firstRowlndex, long lastRowlndex, 

long firstCoilndex, long lastCollndex); 
CMatrixiconst CMatrix<Type> ^original); 

// Destructor 
“CMatrixO : 

// Delete die old matrix and make a new one. 
void resize(long firstRowIndex, long lastRowIndex, 
long firstColIndex, long lastCollndex): 
// Subscript implementation with anay-boimds check 
CVector<Type> Scoperator [J (long index): 
const GVectorCType) &opei:ator[] (long Index) const; 
// Basie aceessors 

long getFirstRowIndex() [return iowerVec;); 
long getLaatRowIndexO Ireturn uppecVec;]; 
long getFlrstColIndexO Ireturn lowerColKdx;]; 
long getLastColIndexO 1 return upperColNdx;I; 
unsigned longslzeO Ireturn Nelements;); 
private: 

// Use a vector tjf vectors to stoie 2-D data 
CVector< CVector<Type.> * >vectorPtr; 
unsigned longNeletnents: 
long IowerVec, upperVec: 
long lowerColNdx. upperColNdx: 

}; 

const long DEFAULT_LOW - 1; 
const long DEFAULT_HIGR - 10; 


Simple Arrays.cp 

// Implementation of (Sector and CMatrix 

#lnclude <stdllb,h> 

/hnclude "SimpleArrays, h" 

i^lfndef Assert^ //when not using PowerPknt 

^Include <assert.h> 

^define Assert_ assert 
jfendif 

template<ciass Type) 

CVector<Type>;:C?ector() 

I 

lower = DEFAULT_L0W; upper - DEFAULT.HIGH; 

Nelements - upper - lower + 1: 
head " new Type[^elementsI; 

Assert_(head nil): 


teiiiplate^class Type) 

CVector<Type>: tCVectordong firstlndex, long lastindex) 

( 

Assert_(lastlndex )™ firstlndex); 
lower = firstlndex: upper = lastindex; 

Nelements = upper - lower + 1: 
head “ new Type[Weiements]: 

Assert_(bead != nil); 


teTnplate<class Type) 

CVector<Type) :: CVector (const CVector<(Type) Sroriglnal) 

( 

lower = original.lower: upper = original.upper: 
Nelements = original.Nelements; 
head = new TypelNelements] ; 

Assert_(head i= nil): 

::ElockMoveData(^original[lower] , head. 
Nelements*sizeof(Type)): 

1 

template(class Type) 

CVector<Type>; i-^GVectorO 
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MkLinux is a complete system^ based on Linux 2 and the 
Mach 3 microkerneL It includes development tools (gcc, 
gdb, perL X11R6.3^ and hundreds of other commands. 

MkLinux builds and runs most Intel-based Linux software. 
It works efficiently and reliably on a wide range of Power 
Macintosh platforms. Visit Apple Computer's MkLinux web 
site (www.mklmux.apple.com) and Prime Time Freeware's 
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MacPerl: Power and Ease 

MacPerl is a robust ajid powerful port of Perl 5 to the Mac. 

It runs under the Finder and MPW, supports Apple Events 
and Toolbox calls^, and is generally quite nifty! For details 
on MacPerl and associated products (book, CD^ etc.), visit 
the MacPerl Pages (www.ptf.com/ macperl). 


Prime Time Freeware 
370 Altair Way, #150 
Sunnyvale, CA 94086 
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(408) 433-0727 fax 


if (head) delete [Ihead; 
head = nil: 


// Note: If Jastindex < firstlndex, aJl dynamic memoiy^ will be freed. 
tet]tplate<class Type) 

void CVector(Type)::resize(long firstlndex. long lastindex) 

{ 

If (heed) delete []head: 
head - nil: 
lower " firstlndex: 
upper = lastindex: 
if (upper >= lower) f 

Nelements ” upper ■ lower + 1: 
head = new Type[Nelements]: 

Assert_(head != nil): 

) 

else Nelements = 0; 

] 

template<class Type) 

Type &CVector<Type)operator[] (long index] 

I 

Assert_((index )- lower) (index <= upper)): 
return head[index - lower]: 


templateCclass Type) 

co=nst Type &CVectDr(Type): roperator [] (long index) const 

[ 

As sert_( (index >= lower) [index (= upper)); 
return head [index - lower]: 


template (class Type) 

CMatrlx<Type)::CHatrix() 

I 

IowerVec = lowerColNdx = DEFAU1T_L0W: 
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upperVeQ = upperColNtix = DEPAtJLT_HIGH! 

//Allocate one row 

for (long i: = lowerVec: r <= upperVec: i:++) [ 
vectorPtt[r] = 

new GVector<Type)' (lowerColNdx. upperColNdx] ; 
Assert„[vectorPtr[r] 1= nil) ; 

J 

Nslements = [uppetVec - lowerVec + 1)* 

(lipperColNdx - lowerColNdx + 1); 


template <class Type) 

CMatrix<Type>: iCMatrixdong flrstRowIndex^ long lastRowIndex, 
long fIrstCoilndex, long lastColIndex) 


1 


vectorPtr.resl 2 e(firstRowIndexH lastRowIndex) ; 

lowerVec “ firstRowIndexi 

UpperVec = LastRowIndex: 

lowerColDdx = firstColIndex: 

upperColNdx - lastColIndex: 

for(long r “ lowerVec: r upperVec; r++) f 
vectorPtr[r] = 

new GVector<Type> ClowerColNdXn upperColNdx); 
Ae3ert_{vectorPtr[r] !“ nil); 

) 

Nelememts “ (upperVec - lowerVec + 1)* 

(upperColNdx - lowerColNdx + 1): 


template <class Type) 

CMatrix<Type>;;CMatrix(con^t CMatrix<Type> ^original) 

f 

lowerVec = original.lowerVec; 
upperVec = original*upperVec: 
lowerColNdx “ original.lowetColNdx: 
upperCo-lNdx " original.upperColNdx: 
vectorPtr.reside[lowerVec ^ upperVec}; 
for(long r - lowerVec: r upperVec; r++} I 
vectorPtr[r] “ new CVector<Type) (original[r]): 
Afisert_(vectorPtr[r] E= nil); 

I 

Nelements - (upperVec - lowerVec + 1)* 

[upperColNdx ■ lowerColNdx 1); 

[ 


template <class Type) 

CKatrix<Type>:;-CMatrix(} 

1 

for (long r - lowerVec; r <- upperVec; r+f) I 
delete vectorPtr[r]: 
vectorPtr[t] “ nil; 


tetnplate<claaG Type) 

void GMatrix<Type>:: resisedong firstRowIndex, 

long lastRowIndeXt 
long fitatCollndex, 
long lastColIndex) 

I 

// Delete old vectors (n>ws) 

for (long r = lowerVec; r <= upperVec; c-H-) I 
delete vectorPtr[r]; 
vectorPtr[r] = nil; 

1 

// Resist’ 

vectorPtr.resize(firstRowIndex. lastRovIndex); 
lowerVec = fitstRowIndex; 

UpperVec = lastRowIndex; 
lowerColNdx = firstColIndex; 

UpperColNdx = lastColIndex; 

// Allocate new vectors (rows) 

for (long r = lowerVec; r <= upperVec; rH-) \ 
vectorPtr[r] = 

new CVectDr<Type) (firstColIndex, lastColIndex); 
Asaert_(vectorPtr[r] != nil); 

J 

Nelements - (upperVec - lowerVec f 1)* 

(upperColNdx * lowerColNdx + 1): 


template^clasE Type) 

CVector<[Type) &CNatrix<Type) :: operator [] (long row) 


I 

Assert_(Crow >= lowerVec) (row <= upperVec)): 

return ^vectorPtr[row] ; 

[ 

teraplate<Glass Type) 
const 

CVector^Type) &CMatrix<Type)operator[] (long row) const 

[ 

Assert_({row )= lowerVec) (row upperVec)); 

return *vectorPtr [row] ; 


^CSolvenh 


(/pragma once 

(/include **SimpleArrays .h" 

// SolvCT Outplil mode!; 

enuiq [NORMAL. ERROR. IGNORING]; 

// C]S< liver is an ‘'idler" LPtriodital which brc^iadcasts status messages. 

class CSolver : public LPerlodical, public LBroadcaster I 

public; 

//These members are generic to all solvers; 

CSolver(LListener ^setup); 
virtual -CSolver0 II: 

void SpendTime [const EventRecord iiinEvt) ; 
void doInputO ; 

void doOutputdnt mode “ NORMAL) ; 
private: 

void Initialize(); // allocate arrays, etc. 
void oneCycle (): // called by SpentlTlmeO 

Uiut32 ’flags: 

// These members are problem-specific: 

void getSun(CHatrix<double> &State); 

void getAcceleratlon(GMatrix<double> estate, 

CMatrix^double) &accel): 

Boolean Integrate(double h): 

Boolean Converged(CMatrix<double) Statel. 

CMatrix<double> State2): 

GVector^ CMatrix^douhle) ) state, acoels; 
CMatrlx<double> inltial.state; 

CVect 0 redouble) GM: // G’mass 
double time, delta_t: 
short last, current, next: 
enumlSun. Mercury, Venus. E_M, Mars, 

Jupiter, Saturn, Uranus, Neptune, Pluto]; 
enum ]K, Y. Z\ 

I ; 

const double TOLERANCE = le-12, //precision 

dt “ le 3 ; //a liny time interval (days) 

const int LINESIZE = SO; //for doInputC) 


^Iver.qi 


i/lnclude <math,h) 

//include TSolver^h" 

//include ‘'CSetup.h'’ 

//include ‘'Flags.h‘‘ 

// Do NOT ineliKle template code in the projea. 

//include "SlmpleArrays.cp" 

// the constructor 

CSolver;;CSolver(LLlstener* setup) 

[ 

AddListener(setup); 

// copy info from Setup 
CSetup - (CSetup*) setup; 
flags = S-)flags; 
delta_t = S-)deita_t; 

Initialize(): 

] 

// called when CPU is idle 
void 

CSolver;: SpendTime {const EventRecord SrinEvt) I 
//pragma unused (inEvt) 
if (’flags & READY) f 

* flags -READY: // turn flag off 
oneCycleO : 

] 
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// Get to begin, 
void 

CSolver:;Initialise{} 

GH,resize(Sim. Pluto); 

initial_state.resize(Stin. Pluto, X. Z): 

state.resize(-1. IJ: 

accels.reslze(-l, 1); 

for (int s - -l;s <" 1:s++) [ 

state[s].resize(Sun. Pluto. X, Z): 
acceis[s].resizeCMercury, Pluto, X, Z); 

] 

last = '1; current = 0: next 1: 
dolnputC): 

getAcceleration(state[last]. aceels[last]) i 
getAcLceleration(state [current] . accels [current] ) ; 
time = 0.0: 

*fla&s 1= READY; 

StartIdiingO ; 


//This is the basic control function, 
void 

CSolver::oneCycle(} 

I 

double h = (*flags & PHASE2) ? delta_t : dt; 

if ({h = dt) Sih ((time + h) > delta^t)) 
h = delta_t - time: 

If (Integrate(b)) ! //converged 
time += h: 

if (!{“flags & PHASE2)) 

If (£abs{tlme - delta_t) < TOlERANGE) [ 

// restore initial slate 

for {long p = Sun:p <= Pluto:p++) 
for (long q = X;q <= Z;q++) 

Btate[laet] [p][q] * lnitial_state[p] [q] ; 
getAcceleration(initial.state, accels[last]}: 
BroadcastKessage(iiisg_DONEl): 
return: 

I 

BroadcastMessageCmsg_C0NT); 

1 

else BroadcastMessage{jEEg_DVRG) r 


// Use Numerov’s metliod to solve the diffetentiil equations, viz., 

// q[k+ll = 2*q[k| -q[bl| + {h^Z/12)*(P[k+l| + 10*F|k| +Frk‘ll) + R 
// where q" = F(t,q [but NOT q']) and R = 'h^6“q“^/240. 

Boolean 

CSolver::Integrate(double h) 

( 

CMatrix<double> trial.state [2] = 

Utate [current] . state [next] I: //copies 
double fac = h*h/l2; 
const longMaxIter = 10: 
long iter = 0: 
short ndx = 0; //flip-tlop 

for (long p = Mercury:p <= Pluto:p++] 
for (long q “ X:q <= Z:q'H-) 

accels[next] [p] [q] = accels[current] [p][q]: 

// Iterate to convergence, 
do I 

for (long p " Mercury;p Pluto:p'H-) 
for [long q ^ X;q <= Z:q++) 
trial_state[l-ndx][p][q] = 

2*state[cucrentl[p] Iq] * state [last] [p] [q] f 
fac ‘ (accels [next] [p] [d] + 

10“accels[current][p][q] + accels[last][p][q]}: 
getSun(trial„state[l-ndx]); 

getAcceleratlon(trial_statG[1-ndx], accels[next]): 

// Divergence check 

if {++iter > Maxiter) return false: 

// (kt ready to try' 
ndx = 1 - ndx: 

[ while (!Converged(trial_state[0] p trial_state[1])): 

// Save result 

for (long p = Sun:p Pluto:p++) 
for (long, q - K:q <= Z:q++) 

state[next][p][q] = trial.state[ndx][p][q]: 
last = current; current = next++: //circular queue 
if [next ) 1} next = ^1: 


Stop reading hex. 


Save time with 
Quadrivio Generai Edit, 
the fast way to edit data fiies 
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Define your file format 

• Easy, familiar C-like statements. 

• Complex formats handled by powerful syntax. 

■ input is checked and compiled os you 

View, edit, or analyze your data. 

• Edit data directly in window. 

• Automatically check values, at your option. 

• File can be larger than RAM. 

Multiple uses: 

• Modify Finder Info and file parameters. 

■ Also edit data in application heaps, 

memory handles, and parameter RAM. 

• View entire disk volumes. 


Quadrivio General Edit 

ADVANTAGES 

✓ Quick insight into data structure conterits, 

✓ Easier than studying MPW’s dumpfile output. 

✓ Faster debugging with clear display of data. 
i/ Saves coding time with direct data editing. 


NEW 


On-line version $195 


Siart using General Edit just 30 minutes from now. 

Visit our web she. See, Learn, and Download. 


http://www.quadrivio.com 


Quodrivio Corporation info@quadrivio.com 
1563 Solano Avenue #360 Berkeley, CA 94707 (51 0)524-3246 
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return true; //conveiTged 


// Compute RHS of differential equation, 
void 

CSolver::getAeceleration(CHatrix<double> ficState* 

CMattlx<double> Ssaccel) 

t 

CVector<dDublG> factor (Sun, Pluto) ; 
double dx. dy. dz, radius; 
long p, pp; 
aint32 ignore = MERCURY; 

for (p = Mercury:p <= Pluto;p-H-, ignore <<= 1} f 
// fiactorfpp] ~GM[ppl/iadiuslp][pp]^3 
for (pp = Sun;pp <= Pluto;pp+t) [ 
if [(•flags & ignore) || Cpp p)) 
factor[pp] ^ 0.0: 
else I 

dx = State[pp][X] - State[p][X]; 
dy = State[pp][Yj - State[p][Y]; 
dz = State[pp][Z] - State[p][Z]: 
radius = sqrt(dx*dx + dy*dy + dz^dz); 
factor[pp] = GM[pp]/(radius*radius*radius); 


for (long q = X:q <= Z;q++) j 
accel[p][q] = 0.0; 

for (long pp = Sun:pp <= Pluto;pp++) 
accel [p] [q] +■= 

factor[pp]*(State[pp][q] - State[p][q]); 

] 


1 

// Keep the centertif-cnass at the origin, 
void 

CSolver: ;getSuii(GMatrix<doublG> estate) 

( 

Uint32 ignore; 

for [long q = X:q <= Z;q++) [ 

State[Sun] [q] = 0.0; 
ignore “ MERCURY; 

for (long p = Mercury:p Pluto:p++, ignore 1) 
if (![*flags & ignore)} 

State [Sun][q] -= GM[p]* State[p][q] ; 

State [Sun] [q] GH[Sun]; 


// Are we done yet? 

Boolean 

CSolver:;Converged(CMatrix<double> Statel, 
CMatrix<double> State2) 


if (!±nput.±a_Qpen()) { 

;:SysBeep(l); 

;:ExitToShell(); 

j 

Input.getllne(label. LINESIZE): 
for (int p = Sun;p <= Pluto:p++) 
for (int q = X:q <* Z;q++) [ 

input >> ltiitlal_state [p] [q] ; 
state[last][p][q] = lnltial_state[p][q]; 

I 

input. get line (label. LINES IZE); // get the <CH> 
input .get line (label. LINES IZE) ;//get tlie next Ine 
for (int p = Sun:p Pluto:p++) 
for (int q = X:q <“ Z;q+f) 

input >> state[current][p][q] ; 
input. getline( label, LINESIZE):: 
input.getline(label. LINESIZE); 
for (int p = Sun:p Pluto:p++) 
input >> GM[p]; 
input.close0; 


//Append the eurrent configuration, or a message, 
void 

CSolver:;doOutput(int mode) 

i 

ofstream 

output(“SolarSys.out", ios_base::out | ios:;app}; 
output, setf (iosjase;: scientific | los_base: isbowpos); 
static charbodyllO][8] = 

[”Snn'*, "Mercury"*. "Venus", "Mars", 

"Jupiter" , "‘Saturn”, "Uranus", “Neptune", "Pluto"]; 

awltcE (mode) [ 
case NORMAL: 

output << time « endl; 
for (long p ^ Sun;p Pluto:p++) { 
for (long q " X:q <“ Z:q++) 

output << state[current][pi[q] << " 
output << endl; 

1 

break; 
case ERROR: 

output « time << endl: 

output << "Diverging!f" « endl; 

break; 

case IGNORING; 

UintlZ ignore = SUN: 
output « "Ignoring 

if (‘flags < ignore) output << "none"; 
else 

for (long p = Sun:p Pluto:p++, Ignore <<= 1) 

If (‘flags k ignore) 

output body[pJ << *\t'; 
output << endl << endl; 


Uint32 ignore = MERCURY: 
Boolean converged - true; 


output.close(}; 


for (long p = Mercury;converged (p <= Pluto}; 

P++, ignore «- 1) { 

If (‘flags k ignore) continue; 
for (long q = X:q <= 2:^1^} 

if (fabs(Statel[p][q] - StateZ[p][q]) > TOLERANCE) 
converged = false; 

1 

return converged; 

1 


_ CSolvcrJJ).cp 

// [npui/outpiit functions, part of CSolver 

fjfinclude <fEtream> 

^finclude "CSetup.h" 

^include "CSolver.b" 

// Read the input file, 
void 

CSolver:idolnput{} 

[ 

char label[LINESIZE]: 

ifStream input("init.dat"}: 


__CSetup.h 

#^pragma once 

("Hnclude " SolarSysApp ♦ h” 

^include "CSolver,h" 

class CSetup : public LDialogBox I 
public; 

enum ( class_ID = *SetU' J; 

static CSetup* CreateSetupStreaffi( LStream ‘inStream ); 
CSetup( LStream ‘inStream ): 

'^CSetup (); 

// GSolvtT contains all necessary 
// knowledge for solving this particuLir pn>blcm 
CSolver ‘Solver: 
double delta_t; 

Dint32 ‘flags: 
private; 

virtual void FiulsbCreateSelf {) ; 
virtual void 

ListenToMessage{ MessageT inMessage, 
void ‘ioParam); 

Int32 Nsteps, Nreport. Step: 
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// dieckbojtts 

enTim 

[SU = 1010. ME. VE. EM. MA. JU. SA. UR. NE. PLcheckboxes V 
DT. NS. RPh //cditatids 

// Resource coast^inis 

const RsbIDT rRtdL„Setup= 1000; 
const PanelUT Setup_0K = 1001t 

Setup_Cancel = 1002; 

// Messages 

const MessageT msg^CONT = 2000 1 

iiisg_DOMl = 2001. 
msg^DVRG = 2002; 


__ CSemp .cp 

// CSemp.cp — a custom dialog (modified LDialogBox code) 

^include <fp,h> 

?Hjiclude "CSetup*h“ 

CSetup* 

CSctop: :CreateSEtcipStream(LStreaiii ‘InStream) 

i 

return new CSetupCinStream); 

] 

CSetup: :CSetup{LStream *litStreaTH} :LMalogBox(inStream) 

// dUed by CreateScLupStrcamO 

1 

CSetup: ;~CSetup() 

{ 

} 

void 

CSetup:;FlnishCreateSelf{) 

I 


// a pointer to the ‘global' Hag? 

SolarSysApp*theApp = (SolarSysAppV) mSuperCocmiander: 
flags = &theApp->Flag.s; 

UReaniinator: ;LinkLlstenerToCcint tola (this, thla, 

rRldL_Setup}; 

// Call inherited LDialogBox's FinishCieateSelfO 
// sets up the de&ult and cancel buttons, 

LDialogBox;:FinishCreateSelf (); 


void 

CSetup::ListeTiToMessage[MessageT InMeasage. void *ioParam} 
[ 

const Int22 statusRpt = 10://to update display' 
static Int32 disp: 
switch (liiMessage) i 
case inag_0K: 

LButton 'OlCJutton = 

(LButton*] FlndPaneByID(Setup_0K): 

DK_Button->Disabie[)‘ 

//Wliat planets are ignored? 

Uint32 temp_flag = MERCURY; 

for [PanelDT k = M£:k <= PLikHn-) [ 

LGontrol *ckbox = (LControlO FindPaneBylD{k): 
if (ckbox->GetValue[) 0} *flags |= tefflp_flag: 

teinp_flag <<= 1; 

I 

// get deJta_t. Nsteps, and reporting interval 

LEditField ‘edt = (LEditFieldO FindPaneByID{DT)| 

LStr255 aStrlng: 

edt->GetDescrlptcir (aString); 

delta_t = [double_t) aString; 

If {delta_t ( dt) I //override 
delta_t ’ dt; 

aString.AssignCdt, FLOATDECIMAL, 2): 
edt->SetDescriptor(aString); 






•CLONE-IT" 1 to 


Visit Our Web Site For Details On How To Receive A FREE CD Duplicator - www.optixs.com 


Macintosh Programmers and Developers... 
PRODUCE and DUPLICATE quality disks 
Quickly and Economically with the “CLONE-IT” 


STARTING UNDER $1,000 

“The XEROX Machine for CDs’* 


Optics Storage Pte. Ltd. - USA 

1162 St. George Ave„ Suite 150, Avenel, N.J. 07001-1263 
Tel: (732) 636-4466 Fax: (732) 750-1793 E-mail: optixsusa@aoi.com 


• 3 in 1 solution of having a CD-Duplicator, a 
Philips 2x/6x Writer (3 in the 1 to 3 Duplicator 
model), and a 12x CD-ROM in one unit. 


• Easy hook-up to MAC systems. Automatic CD 
format detection and transfer to CD-R media. 

• Simple operation with the touch of a button. 


Stand-Alone capability for performing its 
function as a CD-Duplicator. Produces absolute 
identical blt-by-bit copies. 
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1 

edt = (LEditFleld*) FlndPaneBylDCKSh 
Nsteps = edt->GetValue(); 
edt = (LF:ditField*} ?indPaneBylD(RP3 r 
Nrepart = edt->GetValtie{); 

// create solver and launch 
Solver ^ new CSolver(this)j 
Solver->doOutput(IGHOKIKG): 

'flags 1= TRYING: 
break: 

case msg_Cancel: 

mS up G r Conanand e r - > Ob eyC omnau d (emd^Quit); 
break: 

case msg^CONT: 

if (-flags £ PHASE2) E 

If C([+fStep % Nreport) =0) || (Step = Nsteps)) 
Solver->doOutput(}; 
if (Step “ dlsp) \ 

LStr255 aString(Nsteps - disp): 

LEditFleld 'edt = (lEditField*) FindPaneBylD(KS): 

edt->EetDescriptor(aString): 

disp +* statusRpt: 

if (disp > Nsteps) disp = Nsteps; 

I 

if (Step = NstepsJ [ //Allctond 
: iSysBeepd); 

niSuperCacmiand e r - >ObeyCoirmiand (cnid_Quit): 


•flags 1= READY: 
break: 

case msg^DONEl; 

•flags |- (PHASE2 | READY): 

Step “ 1; disp = statUflRpt: 

Solver->doDutput(): 

::SysSeep(l3: : :SysBeep(lJ: 
break: 

case msg^DVRG: 

Solver->do0utput(ERROR): 
mSuperCoinmande r ‘>ObeyGoiiuna nd [ ciiid_Qui t) : 
break: 
default; 

// Pass any others to uiheriicd ListenToMessage. 

LDialogBox::LlatetiToNesaage(lnHessagG+ ioParan): 

I 

1 


St>larSysApp.h 

// StilarS^-sApp-h — the maiii mt>dule 

jl/pragma once 

tfiucludG <LAppllcation*h> 

#include "Flags*h" 

class SolarSysApp : public LApplicatiOO I 
public: 

SolarSysApp (3: // cortstruetor registers all Ph>bii 
virtual '"SolarSysApp(): 

// this overriding funaion pettbrms application hmetk^a'i 
virtual Boolean ObeyCoamiand (GoinmandT inCoramand . 

void * ioFaratn) : 


// or 

// Flags = ihisFlagl [ | thisHag2 


iilpragiaa once 


//App flags 
conat Ulnt32 
const Uint32 
const tJint32 


WORKING - OxOOOQOOOl;//Setup dialog exists 
TRYING = 0x00000002: // finished Setup 
DONE " 0x00000004; // can Save now 


// Sofver flags 

const Dint32 READY - 0x00000010 i//for new cycle 
const Ulnt32 FHASE2 - 0x00000020; // itl main time Interval 


// Ignore flags 
const UlDt32 SUN 
const Utnt32 MERCURY 
const Uint32 VENUS 
const Uint32 EMBAEY = 
const Uint32 MARS ” 
const Uint32 JIJEITER 
const Uint32 SATURN = 
const Uint32 URANUS - 
const Uint32 NEPTUNE 
const Uint32 PLUTO 


“ 0x00100000: 

- 0x00200000: 
= 0x00400000: 
0x00800000: 
0x01000000; 

- 0x02000000: 
0x04000000: 
OxOeOOOOOO; 

- 0x10000000: 
= 0x20000000: 


initial state ()D2442965.5) 

-7.g268531l2272E-D4 

+2.363722282085E-01 

-2.ei4426096269E-01 

+2*1883612766601-01 

-l,650Q71503098E-f-00 

+3*677768183934E+00 

-5*3399764823B5E+0D 

-K49Z977308373E+O1 

-3*802641433020E+00 

-2*S70e49532338E+01 

Jim42965.5Dl (ttJ + dt) 

■7.826790930626E-04 

+2*363479684713E-01 

-2*81461Z891282E-01 

+2,lfl8526517012E-0l 

-1,65Q072244682E+O0 

+3*577762846591E+00 

-5.339981299311E+00 

-1.49297707830eE+Ol 

-8.80263a454393E+00 

'2*8708494253958+01 

mass factors 

2*9591220B2856E-D4 
4.912547451451E-11 
7*2434562096331-10 
8*9970116585578-10 
9,54952S942224E'll 
2*825342103446E-D7 
8*4594685043318 Oe 
1*2888162381388-08 
1*5321124812848-08 
2*276247751364E-12 


-3*154354825996E-03 
+1*925795112940E-01 
+5*934177402B51E-01 
■9.13936948B643E-01 
-H.1782S9968881E 01 
+3.214315993866E-^00 
+6.7199904026908+00 
-1,0132744188568+01 
-Z.690623936169E+Q1 
-8.815842320049E+00 

-3a54358772l20E03 

+1*9259827387208-01 

+5,934099950463E-01 

-9.139336022900E-01 

+1,1781740013938-01 

+3*214321253281E+00 

+6,7199372e4652E+00 

-1,0132747247598+01 

-2.690624016261E+01 

-8*8158453394118+00 


iniiJat 

-1.3478838965628-03 

+7*8585757602068-02 

+2*8476199799088-01 

■3*9627617510218-01 

+9*882482675934E-02 

+1*290688586589E+00 

+3*0044337997638+00 

-4,22636D918526E+00 

-1.079386542938E+01 

+5.89B2L9074445E+00 

-1.347B85783055E-03 
+7.859829766764E-02 
+2.847596969258E-01 
■3.962747340B15E-01 
+9.SS1952799675E-02 
-^l* 290690971220E+00 
+3.004432719300E+00 
-4.226362290905E+00 
-1.0793S6583145E+01 
+5.e9a217ei0075E+00 


m 


// this iiverriding function returns the status of menu items 
virtual void PindCoin]!iandStatUs(Coiii!mandT inCommand, 

Boolean 6outEnabled* Boolean AoutUsesNark. 
Char16 ioutMark* Str255 outNarae)r 

Uint3 2 Flags: 
protected: 

virtual void Startup (); //overriding startup hincrinn 


Flags.h 

// Flags, h — each flag is line bit 
// 

// To set a flag: Flags | = thisFlag; 

// To reset a flag: Flags &=-thisFlag; 

// To toggle a flag: FlagsthisFlag; 

// To test a Dag: enabled = Flags & thisFlag; 

// To initialize Flags: Flags = 0; 


Want to share a URL with the community? 
Send it in to 

<mai]to:urls @mactech.com> 
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hy Dave Mark ©1998 by Metrowerks, Inc., all rights reserved. 


AA 


metrowerks 


An Interview with Steve Wozniak 


This month's coJunm is particularly 
special to me, 1 had the distlnci pleasure 
of getting the chance to interview Steve 
Wozniak (gee, do I need to mention that 
Steve Is one of die founders of Apple?) In 
reading over Steve's comments, I was 
reminded of my early Mac days and of 
the reasons I fell in love with the 
Macintosh. Enjoy... 

Dave: What is your current 
relationship with Apple? 

Steve: I don't have any official 
involvement at Apple, although I am 
happy to represent the company in many 
appearances that I make. I spend a lot of 
time keeping up %vith the products first 
hand and have found that when you buy 
and maintain hundreds of computers 
over the years you get a lot better 
understanding of the customer issues 
than insiders have. 

Dave: What do you think about 
Apple’s future? 

Steve; I worry^ about it as we all do, I 
think that the Macintosh is so good and 
popular that its sales will continue to 
carry the company for many years given a 
reasonable effort not to sell things for less 
than you build them. I think that we’re in 
good management hands that way. I fret 
about the Macintosh future. It’s getting 
harder and harder to find Macintosh 
drivers for the latest interesting hardware 
devices. For example, digital cameras and 
Fax machines with printing ability. 


Since so much of the world is now saturated with computers 
it’s very difficult to make a dent in the mass market, particularly 
the consumer market, with just a .superior product. The choices 
have been made, Apple would have to have a keen sense for 
emerging technologies and markets (in the sense of a new group 
of users, not today's) to overturn the world. It’s t^een about 15 
years or more since weVe had the #1 selling computer in the 
world. But look what happenned to IBM, who was far and away 
the leading computer company. PC computing turned the 
industry around. Perhaps a trend back to centralized systems 
(NC’s) would give Apple another great chance* 

Dave: What kind of computing hardware/software do 
you use? 

Steve: I have been very .staunchly Macintosh-based for ages, 
even in my office/school district servers. The sole PC that we use, 
to manage remote access equipment, is operated from our Macs 
via Timbuktu. Occassionally 1 make use of Virtual PC. My friends 
with Windows machines and NT servers have varied stories to 
tell from '"it works all the time and ! don’t touch it” to ""I touch it 
and it takes weeks to restore tilings.” 

1 have been PowerBook based since die first one, a 
PowerBook 150 1 think. When it came out, my life changed 
draniiilically because of computers for the 3rd lime, the first 2 
times being the Apple T and the Apple Ih Right now I have a 
PowerBook G3. I didn’t find it noticably faster than my 
PowerBook 3400/240 for what I do, except for playing CD- 
Videos and QuickTime movies in hill screen mode. 

1 find that you think quite a bit differently about what’s 
important and what's good when youTe main computer is your 
PowerBook, versus your desktop machine. Desktop-first users 
diink differently atx>ut the PowerBook and don't need *as much* 
built in. 

I refuse to sell one of my Duos, a 2300c, which always 
reminds me of the most delightful year and a half with that 
lightweight computer in laptop environments. 
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I keep a PowerBook 1400 at the ready with every imaginable 
cable for quickly connecting to and debugging network equipment 
(routers, radios, hubs, remote access devices, other Macs), 1 use this 
computer frequently. 1 copied my son^ Jesse, and put 2 recordable 
CD's under the clear top, instead of one of the standard Lnseits or a 
custom printed one. It looks like 2 big eyeballs and is really cool 
and unique, I liave an internal ethemet card, rather than using the 
more awk^^ard PCMCIA approach. This is for quick Telnet hcx)kups* 

My desktop machine is an 8500 with a Newer MaxPower 275 
MHz card, 1 GB of Ram, and a couple of 9 GB HD’s (low 
profile). Also a Jaz 1 GB drive internal and a I2X Apple CD-Rom 
(instead of tlie slower one that used to be there), I have a 
Firewire/fast SCSI card in it but haven't yet edited video digitally 
from start to finish, as it gives me the ability to, 

I think that the 8500 is the best Macintosh that Apple ever 
made. Before this, I would have said that it was tlie lici. 1 like 
computers that go on in time, that stick amund and are stiU usable. 
The 8500 is expandable more than some mcxlem Macs, li will even 
be Rhapsody compatable (fm holding my breath on diis one). The 
8500 has video in and out, always there, easy to use and get to. 
This was a big benefit in my classes as I didn't have to purchase 
and install 3rd party' cards for multimedia projeas, 

I like discovering things that most Mac users wouldn't know 
when I have a lot of Ram. For instance, 1 put 256 MB in the first 
8100's. I discovered that with tliat much Ram it wouldn't boot up 
on the supplied CD-Rom, Turns out that some driver code on the 
CD wouldn't work with more than 256 MB of Ram, and the 
computer had 8 MB on board, Apple engineers told me that they 
got that one corrected. With 1 GB of Ram, you discover that the 
few programs that wouldn’t work with it were the few that you 
tliought would. Apple's Memory' Control Panel won't let you set a 
Ram Disk to laiger than 256 MB, So you can’t necessarily make an 
image of your favorite CD Rom game on a R;im Disk for speed. 
Also, Connectix’s Virtual PC wouldn’t work if your Ram Disk was 
greater than 128 MB due to sharing die addiess s^pace. And Newer's 
MaxPower G3 card wouldn't work with 1 GB of Ram until they 
came out with version 1.3.1 of the software. 

My children have the same compuiers as myself, with as much 
speed, Ram, HD and accessories. Kids learn faster and exceed our 
computer skills very quickly, so they .SHOULD have die better 
computers in a family. My 10 year old Gary is quite involved widi 
QuickTime videos and music and MP3s and recording CDs and 
uses both Ids PowerBook and his 8500 (or whatever other 
computer around the home, over the network) extensively in these 
recent pursuits. 15 year old Jesse primarily uses his 8500 and wanks 
to expand his programming skills and write computer games. 1 hate 
to ,say it, but a PC may fit his needs in the future. 

Dave: What do you think about Microsofts relationship 
with Apple? 


Steve: 1 see it more as a token and portrayed relationship, 1 
don't feel that Microsoft invested money in Apple, They wanted 
a cheap way out of pending patent infringement issues. Buying 
stock isn't making a gift. We might ask whose stock they bought. 
Would it have been a lack of faitli, or an attack, if instead they 
had sold a huge block of Apple stock? 

I don’t think that Apple's heritage is one where we’ll confine 
ourselves to places in the market where Microsoft deems we 
won’t bother them, one in which they are stiU in control because 
of their size. 

I think that much Macintosh software needs to be 
rewritten in order to run on Rhapsody and keep the Macintosh 
faithful, Apple’s greatest gain is if Microsoft does this with 
their key pieces, 

Dave: Who was Apple's most effective leader? Did they 
ever have a chance to win the platform wars? If so, how 
should they have proceeded? 

Steve: The goal from day one should have had more 
emotion and fight and less accounting in it. In the '80s it was 
easy to see that the rampant PC clones were a threat to Apple. 
If the Macintosh was so good and different, it should 
dominate the marketplace. 

We were by then a software company, and the industry was 
driven by software. What apps worked how well was what really 
mattered. The Mac OS helped by keeping Mac apps more 
consistent and supportable and usable. The Finder was the first 
drag and drop app. People bought a Mac for die Mac softw^are, 
not because we had better serial port connectors or a better HD. 
If you could afford it, you tended to buy the superior Mac OS. 

But, we operated as though we were a great hardware 
company. We ran the business as though we were so good at 
making and selling hardware. But we had no way to measure it. 
If you really wanted to buy our software, the catch was that you 
could only buy our hardware. We always spoke of the 
advantages of the tight hardware/software synergy but it's easy 
to see, especially if you've been a heavy Mac customer, that 3rd 
parties did a much better job than Apple ever did at this. Too 
much lying to ourselves. 

Let's say that we have an OS that's so good that it's worth 
$1B per year in profits. We spend $6B to manufacture computers 
and sell the product for $7B. The proFil is all due to the software 
since that's all Mac buyers were really basing their decision on. 
But the company is way up the fortune 500 list. Egos are more 
satisfied. The alternative w'ould be to license the software so tliat 
w'e make $1B per year without the risks and effort and hassle 
and overhead of manufacturing liardware. We're a smaller 
company, but tlie profits are the same. 


so 
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llie leaders of apple were adamantly against licensing in die 
80’s. They spoke of how the Japaneese (and others) licensed so 
much American ingenuity and made tons more off of it. The 
message was that the outsiders were ripping America off and 
therefore we must be losing. But that reasoning is faulty if you 
think about it. Suppose a California company w^rites an OS and 
sells (licenses) it for $100 a copy. An Oregon company buys it 
and builds a computer around it which sells for $3000, You could 
say that they had $3000 in revenues for a $100 licensing fee, but 
it’s easy to figure out that nobody lost out ^md it’s not a ripoff. 

Politicians like to present issues in absolute fashion, as 
diough there is an absolute choice between black and while, zero 
and one, licensing and not licensing. But there’s generally shades 
of gray. In the case of liceasiog, you could .say (cciuld have said, 
tliat is) that Apple loses some sales and some profit for each 
competitive product sold. So we merely set our licensing fee to 
make up for this loss and our profits are unchanged. We just don't 
have to do all the work of making as much hardw^are. So what 
price to license the OS for should have been the issue. It’s 
probably too late for this now, 

Dave: What do you think about Apple’s purchase of 
Next? What do you think of Be as an alternative? 

Steve In education it’s less important what you teach and more 
important to motivate the students to learn. I think that the way to 
inspire and motivate the workers at Apple is to make them feel that 
they are creating their own produa, that they are doing more than 
anyone else, tliat it has value, and to let them take risks, Peihaps the 
former workers were all pretty worthless, and could not managed 
into creating great enougli stuff themselves for a successful company. 
Buying Next communicated a message tliat we weie not creating the 
fiiture of Apple ourselves, bur rather we were buying it. 

Also, along the lines of inspiration and motivation, Steve 
Jobs is hard to perceive as a ‘hero’ at Apple. Even his stock 
selling and not being up from about it don’t ring true in this 
regard. Is he saving Apple or saving Next? 

Although Be was only a start and not as mature as Next, 1 
think that Jean Louis might have been a popular addition to 
Apple and we could have felt like we were designing our next 
OS ourselves. But even he didn’t seem to be acting in Apple's 
interests, more in his own. Still, it’s 1998 and whose to say that 
many 3rd parties would have developed for it anyway? 

We know that ILhapsody will mn on PCs and Macs. Which 
group will be more important to Apple’s future? Wouldn’t it be 
strange if Apple became another of those companies that, for 
business reasons, doesn't care about the tiny Mac market share? 

Dave: How should Apple proceed now? What do you 
think of Steve Js stewardship? 


Steve: Steve Jobs doesn’t use a Mac and won't because it's too 
crappy in his opinion. Perhaps this is the only sort of person that 
can take the necessary steps to guide Apple to profitability and 
future success. I think that there were still alternatives that would 
have been better for Macintosh owners. We could have taken a 
slower approach to a future OS and kept the value of a Macintosh 
purchase higher by devoting resources to developing drivers for 
recent PC hardware, to not leave Macintosh users out. This would 
have kept the price of Macintosh computers higher. We could 
have done this and still proceeded on Rhapsody or whatever. 

We probably should have proceeded one or two years ago 
toward making the education market our prime directive, More 
tfian half of the Mac users in the world are in U.S. K-12 schools, 
and they were the most loyal users. Education is a rapidly 
growing market at present. It’s better to make products for a 
growing market. We were in there but didn’t take advantage of 
it. Education was poorly represented within Apple, and spoken 
of with disdain at the highest levels, but made all the money 
when and if the accounting were straight. 

Dave: What do you think of Apple’s current 
commitment to education? 

Steve: I think that the coniraitment to the education dollars is 
high but tfiai the commitment to educ'ation Is low. That Rhapsody 
server/Mac (or NO client is probably being targeted toward 
education. But Apple wasn’t just a great computer company. We had 
become a great education company and were perfealy poised to 
take advantage of it, I was inspired by insiders that spoke of making 
Apple an Education Technology company, supplying the totol 
technology needs of any school. As die school districts grew up, and 
many are still growing in diis way, the technology choic'es became 
more and more die purvue of MIS departments. They had gcxxl 
reason to cover some bases widi PCs and NT servers in pardoikr, 
even in Mac districts. If Apple had an education division that sold 
bodi platforms with Apple backing and branding, we would have 
been in a much better place to keep the sales connections going 
longer. Buy it all from one company. 

So, we are for Macs in education, and Rhapsody in 
education, but we should be for education, 

Dave: 1 know you are a big supporter of education. Why 
is this so important to you? 

Steve: It started with my father telling me why education was 
so important. Plus an early teacher who made a difference. By 6th 
gmde 1 had a ham radio license and 1 told my dad that I wanted 
to be an engineer like himself. But that my second choice was to 
be a 5th grade teacher AIJ my life thi.s desire to teach, to teach the 
very^ young, stayed strong, 1 came close to completing my degree 
in p5>Thalogy instead of EECS with this goal in mind. 1 regularly 
tutored over the years, all ages of students, and none of my 
students ever got less than an ‘A’. 
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1 aisci enjoyed inleracting with the young, being a part of their 
lives. In 1974, before Apple, Steve Jobs liad me take him down to 
apply for a job. It sounded so inieresting that I applied too. I took 
a week's vacation from my engineering job at Hewlett Packard to 
dress up as the White Rabbit and the Mad Hatter in a shopping 
center, For minimum wage. It was a fun and memorable week, I 
even got to meet and talk with some youngsters who recognized 
my shoes as being the same as the ones the Mad Hatter had! 

Once 1 liad kids in school, the local schools became a big part 
of my life. I had an ethical problem with donating computer labs but 
not giving of my own time, so I started teaching computers and 
gradually expanded my role in the district for many years. Eventually 
it l>ec'ame too time coasuming a job so I worked with the distria to 
gradually develope a computer support depamnent. 

Dave: What legaey remains of your time at Apple? 

Steve: The greatest legac>^ is the feelings alx)ui Apple that people 
liave, much of it due to past publicity of the com|:iany and its origins. 
To myself, engineering was the most demanding discipline 
imaginable. 'Ihe stress near the brink of imfx)ssibiiiry' that a gotxl 
designer, or programmer, has to endure to keep dozens or even 
hundreds of iniercx^nnected facets straight in ifie brain is not 
endumble Ibrever. Tlie greatest new teclinologies need .sm^ng young 
minds. They can go into rmnagemeni later. Aldiough that seems 
ea.sier to me, I'm sure that the ver>^ top managers have such mental 
stress too. But I was lucky to lie able to hastcally retire and devote 
myself, to an unusual extent, to my family, the schools, keeping 
updated with teclinology, travelling, and other fun things with 
friends. My last engineering times wem in designing some remote 
control products. I spent one week tt)taliy altjne in a resort in 
PheonLx to complete some intricate mimjprtxessor cxxle to my own 
stanchtrds. Then i spent some more weeks alone in Maui try^ing llie 
same thing for another micropnxessor in the pnxluct. I came back 
determined to have a more restful life Foiever and hired someone 
else to write that code. Fve never once regretted my decision. 

Perhaps die usual situation is that someone in my pasition goes 
on ic> run a company or take a major role in it. My non-political and 
anti-political seases wouldn't let me do this. I wouldn’t lie good at 
it, rd always be way way too soft. 1 c^n’i imke enemies and want 
everyone to be a friend. So, without this, it’s easy to retire and enjoy 
life. As strange as it might sound. Til be happy when my kids are 
grown and gone and 1 can retire to the Sierras to fish all day. 

Dave: What is your fondest memory of your time at Apple? 

Steve: Fd have to say that it was a miraculous month or rwo 
working on a floppy disk controller. The design was very tiny with 
chips being used In unusual and nonintended ways. 1 couldn’t 
have done the amazing design if Td known anything About disk 
controllers. When I was done, I knew' tliat diis piece of hardw^are 
must be missing sometliing tliat an OS would need, even diough 
It could read and write data on a disk. So I studied an existing 


floppy disk controller circuit with 50 chips, as cc^mpared to my 5 
chips, and discovered that mine did ever more tlian the other one. 
1 was now super excited and made up a somewhat phony excuse 
to work on the softw-are/hardware of it for 2 weeks over Christinas 
vacation. Mike Markkula said that we could bring the floppy disk 
to Las Vegas for the first CES to include personal computers. 

rd never been out of California except for a year of college 
in Colorado. Randy Wiggington and I worked on the floppy disk 
controDer over Christmas vacation, all alone at Apple. We 
worked Chrisunas day and New Year’s day. We had it within 
hours of l>eing done when it was time to catch the plane to Las 
Vegas. In Las Vegas, at our tiny teoth (little more than a table) at 
the convention center, we worked all night to get the last bits 
done. We could type “Run Checktxjok” and the Checkbook 
program w^ould run. One would no longer have to wait a minute 
to read it off of casette tape. Walking around las Vegas, Randy 
won $35 at Craps, although he was only 17. 

At 6 AM we decided to make one backup of our good floppy. 
We would pul the source in our one drive and read one track into 
Ram. 'Ihen put in the destination floppy and write tlie same track. 
We did tliis for 34 tracks and then realized iliLit we’d copied the bad 
floppy onto the good one. It took us until 10 AM to fix that one. 

Eventually, it became time to make a PC board for die 
floppy disk controller. By this time Apple w^as successful enough 
to have a company that designed our various PC boards, for 
printer controllers and the like. But, to my delight, they were 
currently busy with other jobs. This gave me the needed excuse 
to come in nights and lay out the PC board myself with mylar 
tape on acetate. I was in almost every nighr for a week until 2, 
3, or 4 AM. Td come into Apple al)out 10, At one staff meeting 
Steve jobs jumped on me as thougli I was slacking offl 

When I got the board finished it had something like 8 
cR)ssovers, holes connecting one side of the PC board to the other. 
1 stared at it for a very long time tliinking if there was some w^ay to 
reduce this as close to zero as possible, I came to realize that if I 
ran a shift register chip from right to left instead of left to right, and 
changed a couple of gates, tliat I could lay out the lx>ard with only 
5 crossovers. So I tore my layout apart and started from scratch (we 
were nhoa of supplies to make a new one). It took a few nights to 
complete but was precious to me. 

Some rewards in life are extrinsic and observable. Your SLikiy, 
your job title, your clothing, your grades. But some are only inside. 
In this case I knew liow' much effort Td gone to to make the PC 
board perfect, even though no customer w^ould ever see it. It was 
an intrinsic award. So were the rewards of teaching myself to 
design computers in schools that never heard of a computer, where 
1 couldn’t share the worth of my designs with any other person. But 
each design, 1 knew' that I’d accomplished something of value, as 
w'ell as a human could. You don’t need outer acknowledgement to 
know that you did something well. B 
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POWERPLAMT 


by David Catmull 


Desktop Stuffing 


Using Aladdin Systems* 
Stufjlt Engine 


Gentlemen, Stuff Your Engines 

Aladdin Systems’ Siuffli has been 
the standard for compression on the 
Macintosh for quite some time now. 
Rather than keep it all to themselves, 
however, they chose to make the 
Stuffit features available to developers 
through a little file called the Stuffit 
Engine. Aladdin's own utilities use it 
to perform most of their compression 
operations, and they have published 
the API so outside developers can 
contribute to the Stuffit standard. 

The Stuffit Engine API is 
organized into two parts: the general 
calls for Stuffing and UnStuffing, 
working with file segments, etc,, and 
the “low-lever calls that let you poke 
around inside Stuffit archives to add 
and extract files individually. There 
are still some things that even the low- 
level calls don't let you do, such as 
deleting and re-ordering items in the 
archives, but unless you’re writing 
your own Stuffit Deluxe you won’t 
need to go that far. 


The Basics 

In order to use the Stuffit Engine, you must include two files 
from the SDK in your project: the StuffItEngineLib .rsrc resource 
file, and one of the CodeWarrior libraries: StuffItEngineLib, 
StuffItEngine LibPPC, or StuffftEngineLibA4. 

If you want to have the Stuffit Engine built into your 
application, rather than depending on the user having it installed, 
you can pick and chcxise which parts of the engine you want to 
include — Stuffing, UnStuffing, segmenting calls, and the various 
decoding pans (such as BinHex) can be added to your project as 
individual resource files. 

Whether you use the engine externally or internally, you 
will need to obtain a license from Aladdin Systems since at the 
very least you will be linking their library' into your program. 
For more details on licensing terms and fees, contact Aladdin 
Systems <dev.sales(gfaladdinsys.com>. 

To access the Stuffit Engine in your program, you must 
first open it with the OpenSITEngine() call, which returns a 
“magic cookie’' to be passed back in subsequent calls to the 
engine. When you are finished, use OloseSITEngineO to close 
your connection. 

Each of the other calls to the Stuffit Engine has three 
types of parameters: the magic cookie obtained from 
OpensITEngineO, the relevant FSSpec structures (source, 
destination, and result), and a set of options which can be 
specified using constants from StuffItEngineLib.h. These 
options tell the Stuffit Engine such things as whether to 
prompt the user for a destination, whether to delete the 
original items after Stuffing or IJnStuffing them, what to do 
about linefeeds in text files, and so on. 


David Catmull is a shareware programmer living in Berkeley, California. He earned a degree in Computer Science from 
the California State University at Hayward, and is currently studying computer animation at the Academy of Art College 
in San Francisco. His shareware offerings include SmffCM, a contextual menu plug-in that uses the Stuffit Engine; and 
CCMArea, a set of classes for adding contextual menus to PowerPlant applications. These and others are available at 
<h ttp://ww w. kagi. com/dathorc/>. 
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Stuffing with PowbhPiant 

Metrowerks has been working on a set of classes that 
simplify the interface to the StufHi Engine. PowerPlant users may 
have discovered the ^'Stufflt Classes” folder that was recently 
added to PowerPlant’s ”Jn Progress" folder. The folder contains 
mo pairs of header and source files: UStuffItSupport and 
LStuffttArchive. These two correspond to the two categories of 
calls in die Stufflt Engine (high-level and low-level). There are 
more than two classes, though: 

• UStuffItSupport: This class performs all the basic 
operations: opening and closing your connection to the 
Stufflt Engine, keeping track of the magic cookie, and simple 
Stuffing and UnStuffing operations. 

• LStuffltFileList: This is a wrapper class for the 
FSSpecArrayHandle type that is used for Stuffing multiple files 
into a single archive. In the Stufflt API, even if you’re just 
Sniffing one file, you must still create a list with a single item; 
conveniently, UStuffItSupport has a call for Stuffing single files. 

• LStuffttArchive: lliis class is for working with the contents 
of an archive, covering the low-level API calls. 

• LStuffltArcObjectlist: The complement to LStuffltFileList, 
this class wraps around Stuffit's arcObjectArrayHandle type and 
refers to multiple objects inside an archive. 

• StOpenStuffit; A stack-based class which simplifies opening 
and closing the engine. 

Their Example 

The Stufflt Engine SDK includes a sample application called 
Stufflt Scrapbook which uses a neat trick to store its pictures in 
compressed resources. Since Stufflt only works with files, Stufflt 
Scrapbot^k gets around this by writing new pictures to a temporary 
file which is then Stuffed. The resulting archive is read in, and its 
data is stored as a Psit’ resource in the scrapbook file. To display 
a stored picture, it goes through the reverse process. 

Our Example 

Stufflt Scrapbook covers the basics of using die general- 
purpose Stuffing and UnStuffing calls, so for this article well 
focus on the lower level. The example application is based on 
the Drag & Drop File Filter applicatk>n from Metrowerks' 
PowerPlant samples. Our program accepts Stufflt archives 
dropped onto it, and extracts any text files that the archive 
contaias, placing the files in the same folder as the archive. 

Since the example application class FrDropApp provides a 
good enough framework for processing files dropped on the 
application, we only override the OpenDocument method, which 
is called for each file: 

TcxiractorApp: lOpenDoc umtni 

Search the given file for text files to extract 
void 

TextractorApp::OpenDocument(FSSpec ^inMacFSSpec) 

I 

StOpenStuffIt opeiiEngine: 

CStuffItArchive archive[*InMacFSEpec); 

LStuffltArcObjectlist list: 
archiveObject object: 

archive.mPromptForDefltlnatlcin = kDontPromptForDestinatian: 


Try_ [ 

// Assemble a list of text files in die archive 
archive.Reset0 : 

while (archive.BrowseNext(object)} 
if (object,fileType = TEXT^) 
list^Append(object): 

// Extract the files, if there were any 
if (1ist.Count0 > 0) 

archive,UnStuffFr omArchive(list); 
J 

Catch_(caughtErr} \ 

DoQult [) ; 

I 


One of the various options for the Stuffli calls is whether to 
prompt the user for a destination. LStuffItArchive stores the values 
for these options in publicly accessible data members, so the first 
thing we do is turn the prompt option off. This is the first step in 
getting the extraaed files to automatically appear in the same 
folder as the archive. 

Notice the use of our subclass CStuffItArchive instead of 
LStuffItArchive. The subclass was added because we needed a 
couple of things diat LStuffItArchive doesn’t provide. 

First of all, there’s no simple way provided to iterate through 
the hiemrchy of an archive. LStuffItArchive gives you Next(), Up(), 
and Down(), but if you want to just cruise through all the items in 
the archive, you have to figure out for youreelf when to use what. 
Here’s how it’s done: 

CSmifliArchive:: BrowscNext 

Return the next item in the archive, going straight ahead, up, or down 
Boolean 

CStuffItArchive: :Brow3eNext(archiveObject SiOutObject) 

OpenO ; 

if (Imlteratorlnltislized) t 
Reset 0: 

if (mBrowseStack) i 
delete mBrowseStack; 

DiErcwseStack - OL; 

[ 

J 

If (miteratorAtHead) I 
mIteratorAtHead ^ false; 
outObject = mCurrentObject: 
return true; 


// Reset the sitack if necessary 
if (tmBrowBeStack) 

mBrowseStack ^ new LArray(slzeof(archlveObject)); 

// If it's a folder, then browse into it (unless it's empnO 
// Otherwise, try^ to advance to the nett object at this lcv*cl 
// If it's not there, pop back up a level 

archlveObject tempObject,old0bject = mCurrentObject; 
if (mCurrentObject-objectlsFolder && Down(tempObject)) 1 
outObject “ mCurrentObject: 

mBrowBeStuck'>AddItem{fitoldCihJect, sizeof (oldObject)); 
return true: 
i 

else If (Next(outObject)) 
return true: 
else f 

if (mBrowseStack->GetCount {) >1) 1 

mBrowseStack-)FetchiteTnAt(LArray:: index_Last. &outObject): 
trtBrciwseStack->RemoveIteiiisAt (1 .LArray: :index_Last); 
return true: 

] 

else 

return false: 

1 
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The nrsr couple of lines in this method are similar to the 
beginnings of LStuffItArchive’s Next(), Up(), and Down(), with the 
addition of initializing the browsing stack. Then we come to the 
fork in the road: if the current item is a folder, we can browse 
into it. If it's not a folder, then just move along. If there are no 
more files in this folder, weTe done with the current folder and 
it’s time to pop back up a level. An array of folder objects is used 
to keep track of where we need to pop up to, and when it runs 
out, that means the entire archive has been traversed. 

The second addition that CStuffltArchive gives us is an 
alternate version of UnStuffFromArchive(), After turning off the 
user prompt option, this is the second step in making the 
extracted files appear in the same folder as the source archive. 
Unlike LStuffltArchtve;: UnstuffFromArchiveO, this function takes no 
destination parameter, and passes a null value for the destination 
to Sruffli Engine's ExpandFromArchiv 0 (). 

CSt L ilU 1 A rt] I i VC: l ■ n S< 11 h 11 Arc! i i \ c 

.AJtcrfiate vmion of Ihe LStuffllArchivt tall with no dcsiin^tJon parameter 
void 

CStuffltArchive: lUnStufff rotnArchivelLStuffltArcObjectLieti 
inObjectList, unsigned char * InPassvord) 

E 

OpenO : 

StOpenStuffIt engineOpeni 

FSSpec resultSpec: 

OSErr err = ExpandFromArchive ( 

UStuffltSupport;;sCookle, 

&mArchivelnfo, 

InObjectListH 

OL, // Null destination meaas expand to the archive's folder 

firreaultSpec, 

oiProniptForDestination, 

mCreateFolder, 

mStopOnAbort, 

roConflictAetion. 

mConvertTexiFiles, 

inPassword, 

inShowHoProgresa. 

tiAlertCBUPP. 

mStatusCBUPPH 

inPeriDdicCBUFP}; 

ThrowIfOSErr_(err); 


Beyond the Documentation 

Here is a collection of tips and notes tbit 1 have collected, some 
of which are not mentioned in the Stuffit SDK documentation: 

You can convert archives to and from self-extracting 
format using Converts ITtoSEA{) and ConvertSEAtoSIT(), but 
the Engine doesn’t tell you what the name of the resulting file 
is. This is usually not a problem, especially if you don’t care 
w^hat the result is, but if you do and there is a naming 
conflict, it could cause confusion, The way it seems to work 
is this: If the file has the appropriate .sit or .sea extension, it 
attempts to substitute the other extension. If this causes a 
name conflict, or if the original file didn't have the right 
extension, then the name is not changed. 

Although, by meaas of the ExpandFSSpec() call, the Smfflt 
Engine can decode and decompress a variety of non-StuffIt 
formats, the only encoding available is Bin! lex. Again, the 


HQXEncodeFSSpec call doesn’t tell you what the resulting file is, 
so you have to guess. This call, in the case of a naming conflict, 
appends a number to the file name; ‘file,hqx,r’ 

The segmenting functions, SegmentFSSpec{} and JoinFSSpec{), 
will prompt the user for a destination if you do not supply one. So 
if you don’t want any Standard File dialogs popping up, be sure to 
specif}^ your destination. And the destination must be a file, not the 
folder you want the file to go in. 

There are certain resources you must include in your 
program for the Stuffit Engine to use, supplied in 
SluffltEngineLib.rsrc. If tlie file containing these resources is not 
open when you open the Engine, you will get the Stuffit 
registration dialog. This will normally not be a problem for 
applications, but for other projects such as contextual menu 
plug-ins you need to watch for it. 

This is pointed out in the Stuffit Scrapbook notes: eveiy^ time 
you perform an operation with an unregistered copy of Stuffit 
Engine (except for opening it), the registration dialog will appear. 
However, there are times when you don’t want that to happen, 
such as a Drag Manager drag receive handler. Fortunately, there 
is an IsSiTEngineRegisteredO call to help you avoid embarrassing 
crashes and unwanted dialog boxes. 

Conclusion 

If you want your application to have file compression 
features, the Stuffit Engine SDK provides easy access to the 
Stuffit standard. While it does have its shortcomings, such as not 
always infomiing you of how^ it resolves a naming conflict, these 
problems are minor and in most cases not an issue. Overall, the 
Stuffit Engine SDK, especially with PowerPlant’s additions, is 
easy to use and even fun. 

The Stuffit Engine SDK is available from Aladdin Systems’ 
web site at <http://www.aladdinsys.com/dev/engine/enginesdk.html>. 


Want to know what products 
are available for MacOS 
development? Check out 
Developer Depot'“ 
<http:/ /WWW. devdepot,com> 
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MULTIMEDIA 


by Tim Monroe, Apple Computer, Inc. 


Lights, Camera, Action... 


Embedding QuickDraw 3D 
objects into QuickTime VR 
panoramas 


Introduction 

Quick'I'ime VR is a wonderful medium 
for immersing the user in photorealistic or 
rendered virtual environments, but it dtx^snt 
take too terribly long before die static and 
silent niiture of die experience txrcomes 
apparent. By "static" I mean that, for the 
most part, there's no motion, no life, in the 
virtual environment. Understandably, one of 
the most common requests that the 
QuickT'ime VR team has gotten from 
developers is for a way to embed sounds 
and moving objc^cts into QuickTinie VR 
scenes. Althougli the virtual environments 
provided by QuickTime VR are quite 
compelling all by diemselves, diey just 
.spring to life when even small biLs of sound 
or fleeting bits of motion are added tc] diem. 

Adding motion and sound to QuickTime 
VK oliiect movies Isn't very difficult and 
doesn't reciuire any programming You can 
infuse some motion into a VK sc^ne by 
creating what ate called “animated" object 
movies, where a given pan and tilt angle is 
associated not with a single frame, but with a 
set of frames, which are played in sequence 
(and possibly also looped) when the user is 
at tliat p^irticular pan and tilt angle. (This is 
allied “fmme animation".) Similarly, you c'an 
configure any object movie to automatically 
play in sequence all die views of die current 


row in die object movie. (This is called 'View animation’*.) In 
addition, the author of a VR scene can include sound tracks in the 
mcwie file. If a sound track is located at the same time as an object 
ntxle, the VR movie CTintrolIer autoinatically plays the sound track 
when that node is the active node. 

But for panoramas, w hich are by far the most common type 
of VR movies, there is nothing analogous to fmme or view 
animation, and the movie controller simply ignores any sound 
track whose duration overlaps that of the panoramic node. To 
embed sounds and motion into panoramas, you’ll need to do 
some programming. In a previous Macl'ech article (Monroe and 
WoUson, July 1997), we showed how to play sounds that appear 
to come from specific locations in a panorama or tliat are 
ambient in the panorama (emanating from no particular 
location). In this article, Til show^ how to embed rendered 
QuickDraw 3D objects in a panomma. 

There are several olivious uses for this technique. First, you 
might want to populate a panorama with various objects that move 
over time. Imagine a panorama witli a rendered jet flying by in the 
sky, or a rendered ctirousel that spins on its axis in the middle of a 
panorama. These effects are easy to achieve by taking an existing 
3D model, embedding it into a panorama, and dien dynamically 
altering its position or rotation over time. Another use for 
cmlxfdding QuickDraw 3D objects is to serve as a “screen” on 
wliidi to play QuickTime. QuickDraw 3D allows you to map a 
texture onto a 3D object; tills texture can even change over time. So, 
we Cdn use the individual frames of a QuickTime movie as a texture 
for a 3D object. The result is a QuickTime movie superimposed onto 
the 3D object. With a small amount of trial and error to get the 
placement of the 3D “screen” just right, you can play QuickTime 
movies on top of a TV screen in a panorama, for iastance. It’s also 
possible to drop out a solid background of a QuickTime mcMe 
wdien mapping it as a texture and thus get a kind of “blue screening" 
(perhaps to liave people w^alking around inside the panorama). 

The i>asic approach that we’ll use to integrate rendered 
QuickDraw 3D objects into QuickTime VR panoramas is ideally no 
more complicated than the one we used previously to integrate 


Tim Monroe <monroe@apple.com> is a software engineer on Apple's QuickTime team and is currently developing sample ccxle 
for the new QuickTime 3-0 programming interfaces. In his previous life at Apple, he worked on the Inside Macintosh tram. 
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Cross-Platform C++ 

OOFILE and AppMaker keep your options open. 

http ://www.high way! xom.au/adsoftware/crossplatform.htm! 

Experienced cross-pldtfarm devebpen have recommended for years the best way to get true native look-andfeel is to factor 
out your application bgk and develop interfaces separately on each platform. With the AppMaker Code Generator for 
Windows this common strategy is now automated. Generate PowerPlanf (or other) for your Mat^ interface and the 
industry-standard MFOfor Window 

Even better^ with our PowerPlant to MFC Portability Kit, includedfree with the generator, much of your existing 
PowerPlant code will compile directly under Windows. Remember, AppMaker can import screens from current source 
right now to start generating a Windows version, no need to suffer through re-drawing each dialog. 


directional .sounds into panoramas: first, we define an arbitrary^ 
correspondence between the QuickDraw 3D coordinate space 
and the QuickTime VR panorama space. Then we translate 
changes in the panorama's pan and tilt angles into changes in the 
3D camera. 'Hie actual implementation of this approach, however, 
is vasdy more complicated with 3D than with sound, primarily 
because we need to do all the standard 3D setup and rendering, 
in addition to then embedding that rendered image into the Vli 
panorama. Here we'll describe die general process and give the 
code for some of the key steps. See the source code for the 
VR3DObjects sample application for the complete details. 

Before reading this article, you should already have read the 
article mentioned above. Thai article provides a good oveiv'iew 
of the capabilities of the QuickTime VR programming interfaces 
and shows how to use them to perform some simple actions. 
You should also be familiar with QuickDraw 3D. See the first 
chapter of the book 3D Graphics Programming With QuickDraw 
3D for a quick overview of how to use QuickDraw 3D. Also, 
develop magazine has printed numerous good articles describing 
various parts of QuickDraw 3D; consult the Bibliography at the 
end of this article for a list of some of those anicles. 

IJGHTS (etc,) 

First, let's briefly discuss the basic QuickDraw 3D setup. As 
I just mentioned, Pm assuming you're already familiar with 
QuickDraw 3D or with some similar 3D graphics system. It's 
beyond the scope of this article to explain everything you need 
to know m use QuickDraw 3D; the following brief recap is 
intended only to jog your memory. 

All 3D rendering Ls done using a private data stmctuie called a 
view'. A view is really nothing more than a collection of other objects, 
including a camera, a set of lights, a tenderer, a draw^ context, and 
the 3D model. The model specifies the location and geometric shape 
of the objea (or objects) to be rendered, as well as information about 
how tlie tenderer should apply tlie illumination from the lights 
(called illuniination shading) and al>out wliat il^ any texture is to be 
applied to tlie surface of the objea (c'alled texture sliading). 


The renderer determines how the geometric description of 
the mcxlel is converted into a graphical image (for instance, is the 
model drawn in a wireframe outline of ics surfaces or as a 
coUection of colored, shaded surfaces?). The tenderer also 
determines which parts of a model are drawn and which are 
obscured by other surfaces. 

The lights and the camera associated with a view' are pretty 
much just what you’d expert. Tlie lights provide illumination to 
the objects in the model. A view can have one or more lights of 
vary'ing positions and colors, llie camera determines how' the 
rendered model is projected onto a flat screen (called the “view 
plane”). QuickDraw 3D supports several kinds of cameras, wliich 
are distinguished by dieir mediods of projecdon. 

Perhaps the least intuitive part of a view is the draw context, 
which maintains information about a particular drawing 
destinadon. You can use QuickDraw 3D to dnnv direedy into 
Macintosh windows, or Microsoft Windows windows, or even into 
a pixel map (a “pixmap"), a region of memory that is not directly 
associated with a window. The draw context maintains general 
infomiation common to all draw'iiig destinations (such as the color 
to use w'hen erasing the drawing destination) and specific 
iniormation alxiut a particular type of drawing destination (for 
instance, the pixel type and size of an offscreen grapliics world). 

For present purposes, we want to have QuickDraw 3D draw 
into an offscreen graphics world, giving us an image that we can 
later superimpose on the panorama. We’re going to superimpose 
the image by copying it from that offscreen graphics world into 
the panorama's prescreen buffer (the buffer tliat contains the 
unvvarped panoramic image that is about to be copied to the 
screen). QuickTime VR then automadcally copies the prescreen 
buffer to the screen. Figure I shows the flow of pixels. 
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jUM^dal 


myRect = theGWorld->portRect: 



Screen WintJaw 


Pusereen Bubh 


Figure L from geometric description to a screen image 


Accordingly, our draw context will be a pixinap draw 
context. First we need to create an offscreen graphics world to 
hold the pixmap. Clearly, the size of the pixmap should be the 
same as the size of the QuickTime VR movie. 

GetMovieBox{ •theWindovfCbject). fMovie* SmyRect) : 

QTNewGWo rId[ {* ^niyAppData} , fPixGWorld * kOffscreenPixelType * 
tmyRect. NULL, NULL, Oh); 


The QTNewGWorld function is a version of NewGWorld that 
allows you to specify the pixel type of the offscreen graplilcs world. 
The pixel type depends on whether we're running on Mac OS or 
Windows: for Mac OS we use the value k32ARGBPixelFormai and 
for Window we use the value k32BGRAPixelFormat. 

Now that weVe created an offscreen graphics world of the 
correa size and pixel type, we can create a pixmap draw 
context, as shown in Listing T 


listing 1 

CreateDrawContext 

TQBDrawContextObject GceateDrawContext (GWorldPtr theGWorld) 

[ 


TQ3 D rawC ontex t Ofa je ct 
TQ3 PixmapDravContextData 
TQ3DrawContextData 
PixMapHandle 
Rect 

TQBGolocARGB 

float 


myDrawContext ^ NULL: 

niyPMData; 

nsyDCData: 

myPixMap; 

myRect: 

nsyClearColor: 

ayFactor = Oxffff; 


if (theGWorld “= NDLL) return(myDrawContext); 


// set the background color; 

// note tlut RGB€i>lor is defioed in the range 0 - 65535 , 

// whileTQ3ColorARGB is dcfuicd in the range 0.0-1.6; hence the division,.., 
ntyCleatColor, a = 0,0; 

jnyClearColor*r = kClearColox,red / myFactor: 
myClearColor^g - kClearCoIor,green / myFactor: 
tnyClearColor*b ” kClearColor,blue / myPactor; 


myPMData*pixmap,widtli ^ myReet,right - inyRect^ieft; 
myPMDeta*pixmap.height ^ tnyRect^bottom - myRect.top; 
myPMData.pixmap.rowBytes * (**myPixMap)*rowBytes h 0x3fff: 
myFMData.pixmap.pixelType kQ3FlxelTypGRGB32: 

myPMData.pixmap.pixelSlze = 32; 
myPMData.pixmap,bitOrder = kQlEndianBig: 
myPMData.plxmap.byteOrder ” kQ3EndlanBig; 

myPMData,pixmap.image ^ GetPixBaseAddr(rnyPixMap): 

// create a draw context and return it 

myDrawContext = Q3PixmapDrawContext_Hevt&myPMData): 
return {TJiyDrawContext): 


We're going to superimpose the image in the pixmap draw 
context onto the prescreen buffer by calling CopyBits. Obviously, 
we want to copy only the parts of the draw context that contain 
rendered pixels, not the parts that are merely background 
(otherwise, we would overwrite the entire prescreen buffer), 
CopyBits allow.s us to specify a copying mode that replaces a 
destination pixel only if the corresponding source pixel isn't 
equal to the background color of the destination graphics port. 
So, to successfully copy only the rendered 3D objects from the 
pixmap draw context to the prescreen buffer, we need to (1) 
make sure the background of the draw context is a known solid 
color that doesn't occur in any rendered pixels, and (2) make 
sure that the background color of tlie prescreen buffer is set to 
that same known color. The CreateDrawCootext function defined 
in Listing 1 uses the constant kClearColor to set the 
ciearlmageColor field of the draw context data structure: 

const RGBColor kClearColor = (0x1111, 0x2222, 0x3333]; 


In our prescreen buffer imaging completion procedure, we 
call CopyBits as shown in Listing 2, having first set the 
background color of the destination port to the same color. 


Listing 2 

PtescreenRoutitiG selGction 
// get the cument graphics world 

// (on entry; the cimrrtt graphics world is set to the prescreen buffer) 

GGtGWorld(fcnyEWorld, fiimyGDevice); 

RGBBackColor(£ikClearCalor): 

// copy the rendered image to the cierent graphics world; 

CopyBits {(BitMapPtr) & (*myAppData) ->fPlxGWorld->pcirtPixMap, 
(BitMapPtr) fitmyGWorld->portPixMap. 

&{'myAppOata)->fPixGWorld->portRect. 

ATnyGWorld - )'po rtRect * 
sreCopy I transparent* 

OL): 


Camera 


// fill in draw contest data 

iByDCData.clearlmageMethod = kQBClearMethodWithColor: 
myDCData.clearlniagGColor ” myClearColor; 
myDCData.paneStatG = kQ3False; 
myDCData.maskstate = kQ3False: 
layDCData.doubleBufferState = kG3False; 

myPMData.drawContextData = myOCData: 

// die pixmap mu^t remain locked in memory^ for as long as it exists 
myPixHap = GetGWorldPlxMap[theGWorld); 
LQckPixels(niyPixMap): 


So, we now see how to get a QuickDraw 3D rendered image 
from its draw context into the QuickTime VK panorama as displayed 
on the screen. What we need to understand next is how to connea 
the 3D coordinate space used by QuickDraw 3D to the photographic 
space used by QuickTime VR. Clearly, if we place a stationary 3D 
object somewhere in a VR panorama, we'd like it to remain in that 
position while the user pans around, and we'd like it to get laiger or 
smaller when the user zooms in or out. We accomplish this by 
connecting die user's panning, tilting, and zooming to corresponding 
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AppMaker- More than a GUI Builder 


User Interface 



Separate User Interface from Data Engine 
Connect UI items to Data items 

AppMaker makes it faster and easier to make a 
Mac application. Just point and click to declare 
your data structures, and to design your user 
interface. AppMaker generates resources and 
source code to implement your design. 


Data Engine 


Ei ~ /p Data Defs g] 0 


▼RsmSfider 



j- 

DateTime 

Long Da tell me 


Message 

Str255 



Show Alert 

Boolean 



Showicon 

Boolean 



PlagSound 

Boolean 



Sound Index 

Slnt16 



DateStrlng 

stress 



Timestring 

stress 



AmPm 

Sint 16 



^ DocData 






THT 



AppMtiker generates Get and Set functions to 
access your data items and generates code to call 
the Get and Set functions when UI items are 
changed, and to update UI items when data items 
are changed. 


Users describe the AppMaker-generated code as 
“human professional quality.” AppMaker generates 
C, C-H-, or Pascal for Apple’s Appearance Manager, 
CodeWarrior’s PowerPIant, Symantec’s THINK 
Class Library, or for the traditional toolbox. 


AppMaker is just $199 from Developer Depot 

B*0*W»E»R*S (www.devdepot.com) or from Bowers Development. 

Development 

P.O. Box 929, Grantham, NH 03753 ■ (603) 863-0945 ■ FAX 863-3857 
bowcrsdev@iiol.com • hup://members.aol.com/bowersdev 


changes in ihe 3D camera. Tliis is in fact relatively simple, but we 
should first clarify the way that QuickTime VR handles its 
photographic data, since iliis pitxess can be a bit confusing. 

To create a VR panorama, the author takes a number of 
overlapping photographs, which are flat, rectilinear images. The 
VR authoring tools stitch these photas together into a single image 
and project the resulting image onto a cylinder. At runtime, 
QuickTime VR lakes a portion of that cyimdrical projection and 
projects it onto a Hat surface (the user's monitor) to create another 
flat, rectilinear image. These two projections are intended to 
essentially cancel each otlier out, giving the user a flat view that is 
just like the image captured by tlie audior's camem. In other 
words, the QuickTime VK runtime engine provides tlie functional 
equivalent of a viewdinder camera mounted on a tripod that can 
pan horizontally, tilt vertically, and zoom in and out. 

Happily, QuickDraw 3D supports a type of camera that 
provides exactly these features, the aspect ratio camera. To 
configure an aspect ratio camera, we need to specify the 
camera's field of view and the horizontal-io-vertical aspect ratio 
of the view plane, 'fhe aspect ratio is easy to calculate: we simply 
take the ratio of the sides of the movie box. 

myCatneraData. a^pectRatioXToY “ 

(float) (thePort->portRect. right - thePort->tiDrtRe!Ct. left) / 
(float)(thePort’>pottRect.bottom - thePort->portRect* top): 

The field of view is also easy to determine, since we can 
just use the QuickTime VR field of view. The only ''gotcha” is 
that the VR field of view is always the vertical field of view, 


whereas the 3D field of view is either vertical or horizontaf 
depending on whether the aspect ratio is greater or less than 1,0. 
(In other words, the QuickDraw^ 3D field of view is always in 
the direction of the smaller side of the view plane.) listing 3 
shows how we generate the QuickDraw 3D camera settings 
based on the current Quicklime VR settings, 

Listing 3 

SetCamera 

void SetCamera (WindowObject theWindowObJect) 

1 

ApplicationDataHdl uyAppData: 

TQ3View0bject myVievj 

TQ3Cainera0bject myCatnera; 

TQ3CameraFlaceTRent rayCanoraPos; 

QTVKin stance mylnGtatice: 

if (thoWindowObject = NULL) return: 

// get the Q lYR instance associated with the specified window 
my Instance = (’^ *theWindovObject) Instance; 
if (mylnstance NULL) return: 

// get the view object associated with the specified wbdow 

tisyAppData = GetAppDataFromWindowObject (theWindowObject): 

tnyView = (**myApp!}ata), fView; 

// get the camera a^odated with the view object 
Q3View_GetCaiDera(myVieVi SmyCansera) : 

if (n3yCamera [= NULL} I 

float myFOV. myPan. myTilt: 

TQ3Point3D JiiyPoint; 

TQ3Veetor3D mytlpVector: 

// set the camera’s field of view 

myFOV = QTVRGetFieldOfViewtmylnstanee); i 
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if ((“myAppI}flta).fQD3DfOVIaVert) | 

Q3VievAngleAspectCamera„SstF0V{myCanieraH tnyFOV): 

I else f 

float myRatlDr 

Q3ViewAngLeAspectCamera_GetAspectRatio{myCamera» 
&myRatio); 

Q3ViewATigleAspectCamera_SetF0¥[ ray Camera, ciyFOV * 
myRatio); 

) 

// get die camm's current pan and till angles 
myPan ^ QTVRGetPanAngle(myInstance): 
myTilt ^ QTVKGetTiltAngle(mylnstance): 

// calaUatc the new pointof interest 

myPoint.x ain(iiiyPan) ‘ cos (myTilt) * klDObJectDiat; 

myPoint.y ^ Bln(tnyTllt) * k3D0bjectDist: 

myPoint*z = cos(myPan) * cos(myTilt) * klDObjectDiatc 

// calculate the new up vector of the camera 

myUpVector ,K = -sin[Ti5yTllt] * sin(myPan); 

myUpVector,y ^ +cos[myTilt); 

myUpVector .z ” ‘sin(n5yTilt) * cos(iriyPan); 

Q3Vectcir3D_Hormalize f&myUpVector, fiimyUpVector) : 

Q3Cainera_GetPlaoeinent (myCamera, fiimyGameraPos) i 

myCameraPos^upVector ^ myUp^ector; 

myCameraPos^poiatOflnterest * myPoint: 

tnyCametaPos►earneraLocation = kCameraOrigin: 

Q3Camera_SetPlace!nent (myCamera , ^myCainaraPos) ; 

// update the QD5D caracra 

Q3View_SetCamera (myView. tnyCamera) j 

Q30bject_Dispoae{!nyCatnera3 ; 

) 

1 


We call SerCamera in our prescreen buffer imaging 
compfetion prcKedurCj if we determine tliai the pan angle, till 
angle, or field of view angle of the panorama has changed since 
we last set the 3b) camera characteristics. 


Action 

So far, weVe learned the fundamental steps required for 
integrating QuickDraw 3D with QuickTime VR panoramas: we see 
h(jvv changes in the VK envinmment are rellecred in changes in the 
3D camera, and we see how the rendered 3D image is emlx?dded 
into die panorama. Now' ids time to create .sojiie motk>n. 

Of course, tile simplest way to gel objecis lo move around 
in a panorama is to move them in 3D space liy assigning them 
new locations. Once an object is moved, we need to render a 
new 3D image and superimpose it on the pantnama. This can be 
accomplished by calling QTVRUpdate to trigger our prescreen 
buffer imaging completion procedure. 

Another way to create some motion is to rotate an object in 
place. Listing 4 shows a simple procedure that rotates an object 
about the z and y axes. 


Listing 4 

ArtlmateModel 

void AniinateModel (WlndowOfajact theWifidawOhject) 

I 

TQ3f1atrix4x4 rayKatrix; 

AppllcationBataHdl myAppData; 

TQ3Vector3D myVector; 

inyAppEata ” GetAppEataFrouitfindpwObject (theWlndowObJect): 
if [tnyAppData = NULL) return ■ 

// RJtate the object araimd the global z and local y axes 
Q3Matrix4x4_SetRotate„Zt&niyMatrix, kAnimateRadians): 

Q 3Ma t r ix4x4_Mul t ip 1 y (5( (* ‘ myAp p Da ta). f Rot at i o u, iaiyMat r ix, 

&.(*'iDyAppData) .flotation): 

Q3Vector3D_Set(&myVector, 0.0, 1.0, 0.0); 

Q3Matrlx4x4_S etRotateAboutAxis{fiirayMat rlx, 

&(*'myAppData).fCroupCentEr. fidnyVector. kAninateRadiana); 
Q3Hat rl5t4x4_Multiply (i (* *myAppData) . fRotation, &inyMatrix. 

& (* ‘myAppData), fEotationJ; 


AniraateModel changes the rotation matrix of die 3D model; 
when die model is next rendered, its rotation matrix is applied 
to determine its current orientation. 

At the Movies 

Our final task is to apply a QuickTime movie as a texture to 
a 3D object. QuickDraw 3D supports texture mapping as part of 
its general shading architecture. In a nutshell, we need to create 
a new texture shader and attach it to the 3D model The texture 
itself is simply a pixmap that is applied, during rendering, to the 
surface of the 3D object. So, we need to create a new offscreen 
graphics world that is the size of the QuickTime movie whose 
frames will be used as the texture. Listing 5 show's how^ to create 
a new texture from a specified movie. 


NeiifTEXtureFroiiiHoviE 

TextureHdl NewTextnreFroniMovle(Movie theMovie) 


Lui^igned long 

GWocldPtr 

PixMapHandle 

unsigned long 

GDHandle 

GWorldPtr 

Rect 

TQ3StQragePix.niap 

TextiireHdl 


myFictMapAddr; 
myGWorld; 
myPixMap; 
myPictRowBytes; 
myOldGD: 
myOldGW; 
myBounds; 
•myStrgPMapPtr: 
rayTexture “ NULL; 


Listing 5 


tnyTexture = {TextureHdl)NewHandleClear(sizeof(Texture)): 
if {myTexture ” NULL) return [layTextute); 

HIock((Handle)myTexture); 

// save current pejn 

GetGWorldt&myOldGW, &niyOldGD); 

// get the size tjf the movie 
GetMovieBox(theMcivie. ^uiyBounds) ; 

// create a new offscreen graphics world (into wliich we wil draw the movie) 
QTHewGWorid(^myGWorld, kOffscreenPixelType, ^mylounds, 

NULL. NULL. OL): 

myPixMap = GetGWarldPlxHap(myGWarld) : 

LockPlxels (icyPixMap); 

myPictMapAddr (unsigned long}GeiPixBaseAddr(inyPixMap) : 

// g^;t the offset, in by tes, from one row tjf pixels to the next; 
myPictRowBytes “ (*^rnyPixMap).rovBytEa ^ OxBfff; 

SetGWorld(myGWorld. NULL); 

// ercate a storage oh jet l asstJeiated with the new offscreen graphics world 
myStrgPMapPtr “ Si (* ^myTexture) . f StoragePlxinap; 
inyStrgPMapPtr->imagE ^ Q3MecioryStorage_NewBuffer( 

(void MtnyPictMapAddr, 
myPictRovBytes * tnyBounds . bottom, 
myPlctRowBytee rnyBounds .bottom) : 
inyStrgPMapPtr->width ^ raySounds. right; 
rayStrgPMapPtr->helght “ rayBounds,bottom: 
rayStrgPMapPtr^>rovBytes = rayPlctRqwBytes: 
tnyStrgPMapPtr’>pixelSize = 32: 
myStrgPMapPtr->pixelType kQ3FixelTypeRGB32: 
myStrgPMapPtr->bitOrder “ kQSEndiauBig: 
rayStrgPMapPtr->bytsOrder = kQ3EndianBig; 
t*’myTexture),fpGWorId ^ myGWorld: 

SetMovieGWorld[theMovie, rayGWorld, NULL): 
StartMovieCtheHovie): 
bail: 

SetGWorld(myOldGW. myOldGDJ r 
HUnlock((Handle)rayTexture); 
return(myTexture): 


Notice that w^e tell QuickTime to draw the movie frames into 
the offscreen graphics world by calling SetNfovieGWorld, The only 
other thing we need to do is periodically draw the next frame of 
the movie into that graphics w^orld by calling MoviesTask and then 
inform QuickDraw 3D tliat the texture pixmap has changed. The 
code in Listing 6 performs both of these operations. 
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listing 6 


"IT FOUND A BUG IN NY SOURCE CODE THAT WAS OVER 3 
YEARS OLD THAT’S BEEN CAUSING ME FREAKY UNPREDICT- 


NextFrame 

Boolean fJextFrame CTextureHdl theTexture) 
f 

TGlStoragePixmap *niyBtrgPMapPtr: 

long mySize: 

TQ3Status myStatus; 

if ((**theTexture).fpGWoEld “ NULL) 
retiirn(false) ; 

HLock((Handle)theTexture); 

// draw the next movie frame 
if ({•"thelexture) pfMovle) 

MoviesTaak((*‘thaTextnre)* fMovie► 0); 
myStrgPMapFtr = &(**theTexture).fStoragePixmap: 
mySize = myStrgPMapPtr->helght ‘ inyStrgPMapPtr->rovBytes: 
// tell QD3I) the buffer changed 
myStatua = Q3MemoryStorage_SetBuffer( 
myStrgPMapPtr->image, 

GetPixBaaaAddr({* *theTexture),fpGWorld->portPixMap)» 
mySizEi mySize); 

HUnlock((Handle)theTexture): 
return CniyStatus ^ kQ3Succesa) 


We call NextFrame from our prescreen buffer imaging 
completion procedure, just before we render a new image into 
the pixmap draw context. 

The Final Cltt 

Here, I hope youll agree, weVe done noiliing too terribly 
difficult. We’ve simply used the standard* off-the-shelf, QuickDraw 
3D APIs to genemte an image that we overlay onto a QuickTime 
VR panorama, also using standard, offThe-shelf, APIs. Tlie 
essential step Ls the manner in which we link the QuickTime VR 
pan, tilt, and zoom angles with the QuickDi'aw’ 3D camera settings: 
when the VR view changes, we simply alter the 3D camera 
accordingly and render a new^ image to superimpose upon tlie 
panoramas. Die resulting effects, however, are extremely 
compelling, and provide one good method of integrating motion 
and sound with QuickTime VR panonunas. The reviewers give this 
technique two thumbs up! 
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CHALLENGE 


by Bob Boonstm, Westford, MA 



EggLob 

What could he mean by "EggLob”. you ask. Well nothing, 
except that it is an anagram of "Boggle®, the Parker Brothers 
game that Ls the inspiration for this month's Challenge, Boggle is 
played with 16 six-sided letter cubes and a 4x4 tray into w^hich 
the cubes are shaken. The tjbject is win as many points as 
possible by joining letters horizontally, vertically, or diagonally to 
form words. Longer w^ords win more points. This month your 
Challenge is to solve a game like Boggle, widi a few twists. 

The prototype for the code you should write is: 

#if defined (,_cplusplus) 

extkm "C" f 
f^endif 

long Boggle[ 

long d imen s 1 o n, T puzzle is square, of size dimension, 4x4 ro 7x7 V 

char puEz 1 e [] ♦ r letter at (Kw.ctjl) is in puzilclcol+dimeiision'rtmd 7 

long di ct Size, /* nimiber of words in dictionary 7 

const chai: * dictionary []./* legal words to use 7 

char ’ wordsFound [], /* return pointers to the words you found 7 

void *priv Storage /* 20MB of storage for your use 7 

#if defined (_cplusplus) 

) 

i^endif 

Our first twist on tlie suindard Boggle game Ls tliat tlie puzzle 
dimension w'ill vary from 4x4 up to 7x7, inclusive. Your Boggle 
rtiutine will provided the puzzle, a dimension x dimension array of 
characters. The second twist is that you ai^e allowed to cheat, up to 
a point, anyway, You can cheat by picking up any of the cubes and 
exchanging it w^ith any other cube. You can do this as many times 
as you like. You can exchange cubes, how^ever, you ainnot turn a 
culie so that a different letter is on top. (Tve reduced your 
temptation to cheat in this fashion by not telling you what is on die 
other five faces of a cube. ) Once you have rearranged the puzzle to 
your liking, you should find as many words as possible from the 


dictionary of dictSize words, copy the pointers to the wotxJs you find 
from the dictionary into the wordsFound array, and return the 
number of words you found. Your rearranged puzzle should 
replace the original puzzle and be returned to the calling routine. 

Words are formed from letters that are adjacent vertically, 
horizontally, or diagonally. No letter from the puzzle may be 
used more than once w ithin a single word. Words whthin other 
words are legal and scored separately. For purposes of 
matching against the dictionary and for scoring, the letter "Q” 
represents the two letters ^QU7 The dictionary may vary in size 
and content from puzzle to puzzle. 

Words are awarded points based on length. No points are 
scored for words of fewer than 3 letters. Words of 3 or 4 letters 
earn 1 point, words of 5 letters earn 2 points, w^ords of 6 letters 
earn 3 points, words of 7 letters earn 5 points, and words of n 
letters (n>7) earn 5 + 6*(n-7) points. Points are deducted based 
on how long your Boggle routine executes; 1 point will be 
deducted for every 20ms tliat your code executes on my 
8500/200. Negative point totals are possible. Entries that do not 
return after a reasonable time (e.g., 5 minutes) will be terminated 
and assigned the associated negative score. Entries that claim to 
have found words that cannot legally be formed using the 
rearranged puzzle wall similarly penalized. 

The Challenge winner will be tlie entry that accumulates the 
largest point total in a sequence of puzzles. 

The privStorage parameter will point to 20MB of preallocated 
storage for your use. The privStorage will be initialized to zero 
prior to the first call to Boggle. The same privStorage value will 
be provided on each subsequent call, and the contents of your 
private storage will persist from one call to the next. 

This will be a native PowerPC Challenge, using the latest 
CodeWarrior environment. Solutions may be coded in C, C++, or 
Pascal. Thanks to Ernst Munter for suggesting this Boggle variant. 


THE RULES 


Here’s liow it works; eadi montlr we presem a new programming 
diallenge. First, write sfjme code that solves the challenge. Second, optimize 
your code (a tot). Then, submit your solution to MacTedi Magazine. We 
choose a winner based on code correctness, .speed, size, and elegance fin 
ihai order of importance) a.s well as the submission date. Tn the event of 
mulliple equally desirable solutions, we’l! choose one winner (with 
honorable mention, but no prize, given to the runner up), Tlie prize For each 
month's best solution i.s a $100 credit for Developer Depot™. 

Unless .'Stated otherwise in the problem statement, the following rules apply: 
.Ml solutions must be in ANSI compatible C or C++, or in Pascal. We disqualify 
entries witli any as.seml)iy in tliem (except for challenges spedtolly stating 
aherwise.) You may t:all any Macintosh Toolbox lotitine (e g., it doesn’t matter if 
you use NewPtr instead of malloc). We compile all entries into native PowerPC 
code with compiler options set to enable all available speed optimizatioas. Tlie 
development environment to lie used for seleaing the winner will be stated in the 
problem, Umit your code to 60 characters per line or compress and binliex the 


.solutifjn; this helps with e-mail gateways and page layout. 

We publish the solution and wtruiers for each month’s Programmer’s 
Challenge three montks later. All .submissions must be received by the 1st day 
of the month printed on die lk>nt cover of this issue. 

You can get a head start on the Challenge by reading the Programmer's 
Challenge mailing List. It will he posted to the list on or before the 12th of the 
preceding month. To join, send an email to lLsLserv@llstmail,xplain,com with 
the subject “subscribe ch:illenge-A7 

Mark solutions “Ann: Programmer's Challenge Solution" and send it by 
e-mail to one of the Progranimeris Challenge addre.s.ses in the “How to 
Communicate With Us“ section on page 2 of this issue. Lnclude the solution, 
all related files, and your contact info. 

MacTcch Magazine reserves the right to publish any .solution entered in 
the Programmer’s Challenge. Authors grant MacTech Magazine the exclusive 
right to publish entries without limitation upon submission of each entry. 
Author.s retain copyrights for the code. 
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Three Months Ago Winner 

One more time we congratulate Ernst Munter (Kanata, 
Ontario) for submitting the winning Challenge entry, this time in 
the February Image Decoder Challenge. The Challenge was to 
read a GIF image from a file, decode it, and return an offscreen 
GWorld containing the image. Ernst's code was about 5% faster 
than the second place entry by Patrick Varilly, and beat Patrick's 
entry in all but one of the test cases I used. 

A couple of keys to the extra speed in Ernst's code. First, 
notice that almost all of the code is jyari of methods in the GIF class, 
and that all of those methods are inlined. This wouldn't be a good 
general technique for all C++ code, but it provided an edge in this 
application. Second, look closely at some of the loop constructs. 
For example, the portion of the PutMore method dealing with the 
common case, where aH of the decoded pixels map into the current 
image line, compiles as follows with full speed optimizations: 


Top Contestants 

Here are the Top Contestants for the Programmer's 
Challenge, including everyone who has accumulated more than 
10 points during the past two years. The numbers below include 
points awarded over the 24 most recent contests. Including 
points earned by this month's entrants. 


Rank Name 

Paints 

Rank 

Name Points 

1. 

Munter, Emsr 

220 

9. 

Gregg, )^n 

24 

2. 

Boring, Randy 

73 

10. 

Murphy, ACC 

24 

3. 

Cooper, Greg 

6i 

11, 

Day, Mark 

20 

4. 

Lewis, Peter 

51 

12. 

Higgins, Charles 

20 

5. 

Mallett, Jeff 

50 

13. 

Hosteuer, Mat 

20 

6 . 

Nicolle, Ludovic 

44 

14. 

Studer, Tfiomas 

20 

7. 

Rieken, Willeke 

27 

15. 

Hart, Alan 

14 

8. 

Antoniewicz, Andy 24 

16 . 

O'Connor, Turlough 

14 


char* nevDesfdest+len; 


dest=newDest: 
00000014: 70050178 rar 
do [ 

‘^est=stp->value: 
OOOOOOIB: 83040006 Ibz 
OOOOOOIC: 9G05FFFF gtbu 
stp=Btp->pref±x: 

00000020: 80840000 Iwz 
1 while (stp): 
00000024; 38040000 cmplwi 
00000023: 4032FFFO bne 


i:5,r0 

r0,6(r4) 

r0,-l[r5) 

r4.0Cr4) 

r4,SOOOO 

--16 : $00000018 


The assignment via the predecremented pointer dest 
compiles to a single Store Byte With Update (stbu) instruction, 
making this short loop considerably tighter than other possible 
constructs. Very nice. 

Patrick commented in his code that close to half of his 
execution time is spent in tread. 1 remember having the same 
problem at least once when 1 competed in the ChaEenge where 
I resorted to writing a streamlined version of tread. None of the 
entries to this month's Challenge tried that technique, though. 

Eleven different GIFs were used to test the solutions to this 
Challenge, The GIFs ranged in size up to 1100x800 pixels, and up 
to 500KB in length. The table below lists the total execution time in 
milliseconds for five selected test cases and the time for all test cases 
combined. It also lists code size, data size, and the programming 
language used for each enuy-. The number in parentheses after the 
entrant’s name is the total number of Cliallenge points earned in all 
Challenges to date prior to this one (Table 1). 


There are three ways to earn points: (1) scoring in the top 5 
of any Challenge, (2) being the first person to find a bug in a 
published winning solution or, (3) being the first person to 
suggest a Challenge that I use. The points you can win are: 

1st placepoints 5th place .....2 points 

2nd place ......10 points finding bug.. 2 points 

3rd place...,...? points suggesting Challenge...2 points 

4th place........4 points 

Here is Ernst’s winning solution to the Image Decoder 
Challenge: 

GffDecode.Cpp 

Copyright 1998, Ernst Munter, Kanata, ON, Canada 

r 

An impLemenuiion of a decoder of GIF images for the PowerPC Mac. 

Input: a hie conUinitig a single imiige; 
the file is aUtady opened by the calling program 

Output: an off-scrceo graphics world which contains the image. 

Algorithm 

The algorithm foDows dosely the description in the GIF spec, 

GlF89a extensions are necognized but their data blocks are 
skipped over and not pmcessed. 


Table ; 


Execution Time (msecs) Code Data 


Name 

T«t,l. 

u. easel 

Cases 

Case4 

CaselO 

Casell 

u 

Size 

Size 

Lang 

Ernst Munter (330) 

2145 

431 

548 

35 

193 

218 

3960 

8 

C++ 

Patrick Varilly 

2235 

471 


43 

209 

228 

2900 

155379 

C+ + 

Willeke Rieken (20) 

3274 

'■■■■T' 1- 

760 

'705 

60 

307 

322 

4848 

168 

C++ 


T 
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Impkmentution Notes 


The fiJe is read, one large block at a time, into a buffer 
Rle and image headers are processed according to the GIF 
spec This includes constructing a Mac color table from 
either the global or a local GIF color table. 

The LZW decoder draws variable size cixles ikim the buffer, 
maintains a code dictionary, and writes decoded pixel value's 
directly into the GWbrld pixel map. 

Decoding a single compressed code word yields a string of 
pixels in reverse order The conventional method would be 
to push the pixels on a stack, and then pop them off as 
they are written to sequential pixel addresses in the pixel map. 

I use this method if the pixel string goes past the end of 
the current n>w, in order to deal with extra byies (rowBytes 
may be greater than image Width), and to handle interlaced row 
sequences correctly. In the normal case however, die pixel 
values are copied directl>' from the code dictionary to the 
pixel map. To facilitate this, I store the length of each 
tilde string In the dictionary record, 

V 

^include <stdlih,h> 

//include (string.h) 

//include ''ImageDecoder ,h'' 

ennm [kBlDGkEize=l6384. 
kMaxCode=4055. 
klEageSeparator-0x2C, 
kExtensionIntroducer“0x31I: 


DictEntiy^ 

struct. DictEntry I 

U Each dictionary entry is the start of a linked list 
// of letigih one or more. 

// The stackedVahie locaittui is unrelated to the dictitmary 
// entry; it is jusi a convenient spare location 
// to build tlie pixel stack, in memory^ that is likely 
// already in cadie when it is needed. 

DlctEntry * prefix ; // chains to pre\1ou.s code 
short length: //length of chain 

unsigned char value; //the pixel value 
unsigned char stackedValue: 

void Reset(Int ch)I 
prefix“0: 
length=l; 
value^ch: 


void Inlt[CictEntry* px.int ch) I 
prefix=px: 

length”l+px-)length: 
value=ch: 

1 


struct GIF I 
fILE* f: 

Rent screenRect: 

GWorldPtr osWorld: 

CTabHandle globalCTIJ: 
int logScceenWidth] 

int logScreenHelght; 

int bkGndColor; 

int interlace: 

char* pixelBaae; 

char* itnagEBase: 

int rowBytes: 

int imageWidth: 

int readPtr: 

DictEntry d [40^16]; 

unsigned char block[kBlockSize]: 


GIFrGIf 

GIF[E1LE* fx) i 
f=fx: 

fread (block, 1, kBlockSize, f) :// start by loading I Mock 
readPtr^O: 

1 


GIF:: CheekSignature 

bool CheekSignature{) 1 
// the file signature must be either GrF87a or GrF89a 
if (0x47494638 1= *( (long*)block)) 
return false: 

int version=*({short*)(block+4)): 
if ([version [- 0x3761) (version 1= 0x3961)} 

return false: 
readPtr-l-=6: 
return true: 

[ 

void SkipBytes(int n2skip) ( 

7/ Skip over n2skjp bytes in tile block 
readPtr+=n2skip' 
while (readPtr)=kBlockSize} i 

U We cannot skip past the end of the bit lek without 

7/ loading the next block 

readPtr-=kBlockSize; 
fread{block,1,kBlockSize,f): 

1 

] 

GIF::SkipBytes 

unsigned int RaadlByte(int h readPtr) [ 

7/ Returns the next byte from the file block. 

7/ If we get to the end of the block, we ioatl another 

const unsigned int rc=block[readPtr++]: 
if (readPtr)"='kBlQckSiza) f 
readPtr=0: 

fread(block,1nkBlockSize,f)i 

j 

GIF:: Read! Byte 

1 

return rc: 

1 


unsigned int ReadShortC) 1 

77 GIF files use little endian integers. 

77 This function reads two bytes and rehTns a 16-bit int. 

const unsigned int loByte^ReadlByte(readPtr 
const unsigned int hiByte“ReadlByte(readPtr 
return MByte((3 | loByte; 

1 

GIF;:ReadShori 

): 

): 


Gir::Makef.Tah 


CTabHandle HakeCTabdnt size) ( 

// Creates a QuickDmw cedor table from a CilF color table 
CTabHandle CTH”{CTabHandle) flewHandle ( 
slzeof(ColorTable)d 
slzeof[Colorspec)*[size-1)); 

CTabPtr CT=*CTH; 

CT->ctFlags=0: 

CT->ctSiza=size-l: 

ColorSpec* cs-CT->ctTable; 
for [int clndex=0;clndex(size:clndex++) 1 
ca-)value=clndex: 

// Expand 8-bit colors to 16-hir colors 

cs->rgb,red=257 * KeadlEyte{readPtr) : 

CE')rgb.greGn=257 * RaadlByte(readPtr); 
CE-^rgb.bluE^257 * RaadlByte[raadPtr); 

CS-H-: 

[ 

return CTH: 


GIF::ProceasHeader 

GWorldPtr ProcessHeader() [ 

// Returns a new offscreen gWbrld. 

// Returns G in all cases of error 


GIF 

// the GIF nie 
// size of graphics world 
// the graphics world 
// a global color table 
// Gil- logical screen 

// GIF specilied bkGnd 
// to ttack interlace passes 
// Sian of GWorld pixMap 
// start of image in pixMap 
// width of pixMap 
// iniageWidth <= rowByles 
// index into file blf>ck 
// the code dictionary 
7/ the file block 
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if (ICheckSignatureO) return 0: 


// Define logicaJ soeen size 

logScreenWidth^ReadShortO j 
lcigScreenHeight=ReadEhort 0 : 

SetRe[:t(&screeTiRect, 0, D .logScreenWidth .logScreenHeight): 
// Read flap 

const int flags=Rea<ilByte (ceadPtr); 
const int hasGlobalCT=flags i 0x80: 
bkGndColor=ReadlByte(readPtr); 
r ead P t r ++: // pixel aspect ratk i is ntit needed 

if (hasGlobalGT} I 

const int CTsiza=lL«C (flagsi7]+l): 
glQbalCTH“M3keCTab(CTsixe) ; 

CTabGhaaged(globalCTH)r 
I else glohalCTH=0: 

//Try to get a new Stiit oflscreen gWorid 
const OSErr err ^ 

NewGWorld (fiiosWorld»8,isscreanRect ♦ globalCTH, 0<0): 

// Qnickdraw will not free this handle for usl 

if (glohalCTH) DisposeHandletCchat**)globalCTH): 

If {err] return 0: 
return osWorld; 


GIFr: ProcessExtension 

void ProcessExtenslon() I 
//Just read and igncjre the txtctiston iabcl 
ReadlByte(readPtr); 

// and skip over any extension data blocks 
do I 

const int bsize“ReadlByte(readPtr}: 
if (bsize^O) break: 

SkipBytes{bEize): 

} while(1): 


GIF::ProcessImage 

void ProcGssImageO ( 

// Read the image header to determine image dimensions 
// which could be different from the logical screen 
const int imageLeft^ReadShort(): 
const Int imageTop^ReadShort() : 
iinag e Ba s e=p ix e IBa a e+lma g e T o p * r o wBy t e s tlina geLe f t; 
imageWidth-ReadShort0: 
const int iinageHeight-ReadShort(): 
const int flags=ReadlByte(rGadPtr): 
const int hasLocalCT=flags & 0x80: 

// DetemiLne interlace geometry 
int skipBytes: 
int stride: 
if (flags & 0x40) I 
interlace-8: 
stride=8‘rowBytes: 

1 else \ 

lnterlacE=l: 
stride=rowBytes: 

1 

skipBytes=stride-iniageWidth; 

// Draw background color as required by Uie GIF spec 
// (onty^ needed if the image does not fill GIF logScneen) 

If ((globalCTH) 

&& ((logScreenHeightMmageHeight) 

II (logScreenWldth>iittageWidth)}] [ 
iiiemset (pixelBase»bkGndColor.logScreenHeight*rowBytes): 

1 

//The image might have a local color table which replaces 
// the global color table. If so, we must update the gWorld. 
if (basLocalGT) ( 

int GTai2e=lL«((flags&7)+l): 

CTabHandle localCTH-MakeCTaMCTsize): 

// 5 9 13 17 21 25 29 33 37 41 45 49 53 57 

UpdateGWorld (SiOsWorld. 8, iacreenRect. localCTH, 0,0) ; 

CTabChanged UocalCTH): 

DisposeHandleC(char *)localCTH) r 

I 



Speed is essential in ell database projecis. but not at the expense of stability. You 
wouldn't try to go IDO miles per hour with your bicycle! The same is true in database 
technology. FairCorri has been delivering fast. safe, full-featured database engines to 
the commercial marketplace for 19 years. Proven on large Unix servers and 
workstations, c-tree Plus's small footprint and exceptional performance has also 
made it the engine of choice lor serious commercial developers on Windows and 
Mac. Check out www.faircann.com for detailed information. Youll be glad you did. 



Platforms; 


c-tree Plus* key 

- Royalty Free 

- Portable Multi-Threaded API 

- Complete C Source 

- Thread Safe Libraries 

- Standalone or 
Client/server 

- Complete Transaction 
Processing, including 
automatic recovery 

- Save-points 

- Abort/Commit 


features for $895: 

- RolMorwards/Roll-back^vards 

- Easy make syetem 

- Advanced Variable 
Length Recorda 

- BLOBS 

- Space Management 

- Rle Level Security 

- Ccndrtional Indeix 

' ODBC/Java Interfaces 
' Over 25 Developer 
Servers included 


MIPS ABI 
BBOFBM 
AiX 

RS/SDOO 
□BC Alpha OSF/I 


HPOODD 
Sun DE 
SunSWe 
DOB 

□S/a 


Mac 

Windows 35t 
Wndems NT 
Windows 3.1 
Irteractiva Unre 


SCO Banym VINES 

Linux QNX 

Chtrua 

ATGT Svstem V Lynx 

Nstwar^ NLM 




DEVELOPMENT SYSTEM 


Half af your Qient/Server project Is the Server! You control 100% of your Qient 
Side. Why settle for less on your Server side? Move your functions to the server- 
side Co decrease network traffic and increase performance! 

Today's database demands may often be too complex for traditional Relational Model 
Database Servers. Server needs come in many different sizes and shapes. What 
bectsr vway to accommodate these requirements than by allowing the developer to 
take full control of Hie Server side? FairCtom's Server Development System was 
created to meet this need. It provides the developer the means to create an 
industrial strength Server Complete make-fifes are induded for all FairCum 
commercial platforms. With mr proven kernel add or override existing database 
functionality or create your own special multi-thraaded server: 

Application Server Network Gateway Server 

Data Warehouse Special Web Server 

Departmental Database Server Embedded Servers 


FairCom Server Development System key features: 


Provides complete source code for alt the interface subsystems to the FairCom 
Server. Server mainline, Communication, Threading. Remote function interfaces and 
procadure calls are all supplied in complete C source code together with the 
FairCom Server sophisticated thread-safe kernel libraries. 


Customizable 
Transactim Processing 
□ata Histfry 
File Mirroring 
Rollback-Fcrwand 
Anti-Deadlnck Raanfiitim 


U Ma 'o geneoos N^niotitmg Small Memory Footer^ 


□lent Side Source 
Multhttir^ading 
Candftimaf Indlex 
MuhJph Protocols: 
ADSR SPX. TCP/IP 


□EM pricing 
□OBC/Jawa interlace 
Key level locking 
□nline Osekup 
Disaster Recovery 






conponation 


Commercial Database Technology. Since 137S 

USA. BaO.S34.aiBO 


Phane; USA 573.445.6B33 • EUROPE +39.35.77 3.464 

JAPAN +81.0592.99.7504 • BRAZIL +55.14.224.1610 
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Decodelmage(stride.skipBytes,imageEelglit): 


1 


GIF::DectxieImage 

void Decodelmagednt stride, int skipBytes^const int 
ImageHeight) I 

// Set up the pointers for writing the pixel map 
char* pixelStore=iiiiageBase: 
char* end Of Row= ima geB a s e-i-iitia g e W i d th: 

const char* endOfImage^endOfRov+(imageHeight-l)*rowBytes; 

if Set up initial code parameters and working variables 
int iiiinGodeSize=ReadlByte(readPtr) : 
const int clearCode=i«minCodeSiae: 
for (int i^O: i<clearCode: i-H-) ( 
d[i] ,Reset Ci}: 

] 

int codeSlze“ 0 iinCodeSize+l \ 

unsigned int bltMask=(lL«codeSlzG) -1: 

unsigned int bitBuffer=Or 

int nextCode=clearCode+l; 

int oldCode^Q: 

int bltsLoaded=0: 

bool dictRull=faIse: 

int bsize; 

int localReadPtr-readPtr: 

// Read the file data, one GIF data block at a time 

while C0<(bsize=RGadlByte(localReadPtr])) f 
int chr 

// Read the data of one GIF data hUKk, and convert to pjxeis 
do I 

// Read the next code 

while {bitsLoaded<codeSize) [ 

unsigned int next Byt e=Rea d1Byt e(1ocalRead Ft r); 
bitBuffer |= nextByte<<bitsLoaded: 
bitsLoaded+^B; 
bsize-; 

if [baize<=0] break; 

t 

If {bitsLoaded<codeSize) continue://end ofbkK:k 
unsigned int £iode”bitMask h bitBuffer; 
bltsLoaded -= codeSize: 
bitBuffer >>= codeSize; 

if Ccoda==clearCode) t 

// Reset codcSi^ie, and start aU cjwr 

nextCode“clearCode+l: 
codeSize=^mlnCodeSlze+l: 
bitMask= (lL«codeSi ze} -1; 
oldCode-D: 
dictRull=false; 

) else 

if {code=cleaLCode+l) I 
// We arc done. 

return: 

I else [ 

// Decode pixel string 

if (code <next Code) [ 

// Code a^-ailable in dictionaiy^ 

if {cQde<clearCode] I 
// root code represents a single pixel 
cb=code; 

pixelStore-PutlCch» stride,pixelStore. 
endOfRow»EndOfImage,skiplytes): 

I else [ 

// a string of more than I pixel 

pixelBtore-FutMore (code, stride, pixel Store, 
end0fRow.endofImage,sklpBytes ^ eh); 

I 

// Add next code to dictionar}'' 

d [nextCode],Init(d+oldCade * ch); 

I else I 


// Anticipated code, we know it ivilJ be ‘"nextCode" 
int dummy; 

//Add to dictionary first, then decode 
if (IdlctFull) [ 

// Must not change dictionary if already M 

d[nextCods],Init(d+oldCode * ch); 

} 

pixelStore=PtitMDre (code* stride, pixelStore, 
endOfRow,endOfImage * skipBytes * dummy): 

] 

oldCode=code: 

// Alwavs just mcremeni nextC(Kie except when the dictionary 
//isftiii. 

// Anytime nextCode exceeds the current biuMask^the codeSize 
// must increase by I, and the bitMask stretched by 1 bit 
if CnextCode<!kHaxCode) I 
nextCode++; 

if (nextCode>bitMask) f 
bitMask nextCode: 
codeSize'codeSiae+1; 

] 

} else dictFull=true: 

I 

) while(baize); 

1 

// Note: if we wanted to continue processing after decoding 
// just one picture, we would need to restore the 
// globai readPtr before returning from this function 
1 


GIFuNextJ^s 

char* NextFasa(int & akipBytes,int & stride) { 

// Defines parameters and the suiriing row for the 
// next interlace pass. Diies not get called with non- 
// interlaced images, but provides robustness for them 
// in ease the GEF file is corrupted: it prevents writing 
// past the end of the pixel map. 

stridG^lnterlaee*rowBytes; 
if {interlace>l) iiiterlace/=2: 
skipBytes=stride-imagaWidth; 
return imageBase+(rowBytes^interlace); 
t 


GIF::PutMorc 

char* PutHore( 

const int code.Int & stride,char* dest, 
char* &endOfRow.const char* endOfImage, 
int & skipBytes*int & firstChar) I 

// Decodes code and puts several pixels into the pixel map 
// and returns the updated pixel write pointer 
DictRntry* stp^d+code: 
int lGE'=stp - )length; 
char* newDest=dest+len: 
if (newDest<-endOfRow) ( 

// Everything fits in the same line. 

//We just put the pixels directly into the pixMap, 

// suuting at die end of the string. 
deat=aewDeat: 
do [ 

*-dest-stp->value: 
stp”stp'>prefix: 

1 while (stp): 
fir&tChar=*dest; 

// ncwDesl poiiiLs to the next pixel to be painted 
return newDeat; 

I elee { 

//Wc may have to handle one or more line breaks. 

// Pixels past the end of the current line are pushed 
// on a stack, then the pixels in the emrent line 
// arc painted; finally the pixels in the stack 
// arc poppcxl off in reverse order, skipping past 
// extra-bytes at line ends. 

// If we reach the end of the image betbre the stack is 
// empty, we must be in interlace mode and call a newPassQ 
// to find the next row to write to. 

DlctEntry* staek^d’f'len; 

DictBntry* endStack=stack: 
int overflovi^newDest-endOfRow; 

for {int k=0; k^overf 1 ov; k++) [ // stack pixels in reverse 
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II 

|] rtaliano.. 


S ininlFtB 


ProdiHi 


Whether you ore venturing into inferriafionol markets for ^ first time, or uprlQling a previous 
version of your product, we con help you get to morket quickly with fully translated softvnire. 
We offer o broad range of internationalization and localization services supporting all oi^cts 
of your product, customizable to meet your exact needs. Call us today for a free consultation. 


Software Engineering 

im 

Docimentatian 

*21 

PatlcBgli^ 


On-UneHelfj 


1 Web Developrrr^t 

nsl 

I PBtosheetf 


Marketing Matertak 

*t| 


flrstChar^stp- > value: 

(-stack)->stacked?alue=fir3tChar^ 
stp=stp“>prefix; 

1 

if (stp) i // paint pixels for the current line 
dest=endOfRow; 
do [ 

firstChar=stp->value; 

*-dest=firstChar; 
etp=stp■^prefix; 

1 while (stp): 

do I // paint pixels from the stack, going forward 
dest=endOfRow+skipBytes: 
if (dest>=eTidOfIiaage) I 

dest=NextPa3s{skipBytes»stride); 

\ 

endOfRow^dest+imageWldth: 
do [ 

*desti+"(stack’H-) stacked Value ; 

J while ((Etack<endStack)&&(dest<endOfRow)): 
I while (stack<endStack): 

// dest points to the next pixel to be painted 
teturn dest; 

I 

J 


GIF::Putl 

char* Putl( 

const int code.int stride,char* dest, 
chat* SendOfRoWtconst char* endOfImage, 
int fifSkipBytes) 1 
// Puls 1 pixel into pixMap 
// and returns the updated pixeJ write pointer 
if (dest>=endOfRow) { 
d e st+=s kipBvtes; 
if [ deEtT^ndOfImage) | 

dest=NextPass(skipBytes,stride]: 

J 

endOf Row=desfi'iiiiageWidth: 

) 

*dest-H-=code: 
return dest: 


Readlmage 

GWorldPtr ReadImage(FILE* inputFile) { 

//The externally dedajtd hmetion 

// Initialize a GIF structure 

GIF* gif=new GIFCinputFile); 
if C0=gif) return 0: 

// Check signature, and create the off screen world 
GWorldPtr osWorld=gif->ProcessHeaier (): 
if (osWorld) 1 
// Using the geometry of the os^world 

PixIlapHandle pmHdl=GetGWorldPixMap(osWorld); 
if (LockPixels (ptnHd 1)) ( 
gif - >pixelBase=GetFixBaseAddr (piuHd 1) ; 
gif - >rowBytGS=(* *pniHdl) * rowBytes & OxlFFF: 
do f 

// Start reading the GIF data and look lor the image separator 

int separator=gif■>ReadlByte(gif-kreadPtr); 
if (separator—klmageSeparator) I 

gif->Process Image C) ://Thb is what it’s about 
break; 

I else if (EGparator=^kExtGnslDnlntroducer) 1 
gif->ProcessExtensionf)://these are ignored 
\ else break: 

) whiled): 

lliiIockPixels(pmHdl): 

I 

1 

// Clean up temporary memory allocations 
delete gif: 

return osWotld; 

1 
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Subject to Interpretation 


The Other Kind of ScRiFnNG 

Here's the deal; Scripting languages are becoming a big 
tiling these days, and the Macintosh is by no means being left out 
in the cold. Scripting languages integrate with java, complement 
Java, provide alternatives to Java, and stand on their own. We’re 
going to use this month’s issue on java as a jumping-off point for 
learning about some lesser-know n languages for die Mac. 

What Scripting Languages Are Not 

Scripting languages are not newcomer replacements for 
AppleScript or Frontien “Tradilionar scripting languages (if there 
is such a diing) developed in the Unix w'orld. Like AppleScript, 
they tend to siiidi together pieces written in languages such as C 
and Pascal, but there is an impoilant distinction: whereas 
AppleScript operates primarily on upplkatium, these scripting 
languages cjperate primarily on data, 'fliey may rely on 
components (analogous to Scripting Additions, or OS.\X), and 
they can l>e made to interface wadi AppleScript, hut they are a 
different breed, grown up with a different focus in mind. 

Scripting languages are usually imerpmed meaning that 
they run directly from human-readable programs, rather then first 
t>eing compiled into machine-executable form. As a result, they 
require an interpreter to run — the analog of the java virtual 
machine. To an even greater extent than Java, this allows 
platform independence. For those who arc not impressed by diis, 
or who worry about execution speed, many ,scripting languages 
are developing compiled implementations. 

To get started, check out the excellent article Choosing a 
Scnptwg Lcuigimge on the SunWorld site, wliich does a great 
job of introducing the big playerst Peri, TcL and Python, and 
of getting the reader excited about them. Then, check out 
Scripting: Higher Level Programming for the 21st Century, 
which explains in detail how^ and when ,scriptiiig languages 
can be more pow^erful and conveniem than system 
programming languages, like C++ or Java. 

Choosing a scripting language - SutiWorld - October 1997 

<http://www.sun.coni/sunworldonlineAwol-10-1997/swol-10-scripting. html> 

Scripting: Higher Level Programming for the 21st Century 

< http://WWW. su niabs. com/- ouster/scri pti ng. htm l> 


Perl 

Perl (the Practical Extraction and Report Language) begin as 
a language for manipulating text and extracting information from 
it, sporting such power features as built-in regular expression 
(a.k.a. grep) capahilitjes, and accordingly has become popular for 
writing CGI scripm to generate web pages on the fly, it is probably 
the most well-supported of the scripting languages on the Mac, 
with a CD and a fortlicoming book from tlie Fiee Software 
Foundation, which hosts the MacPerl pages, Perl could be a nice 
teacliing language — the MacPerl book aims to serve as a guide 
for tliose learning Perl as their ver>^ first programming language, as 
well as introduce the language to experienced programmers. Don’t 
let Peri’s text-based roots put you olT — they are only one of its 
strengths. It is a large language wath an emphasis on practicality 
and the motto 'There’s More Than One Way To Do It,” 

The MacPerl Pages 

< http://WWW, ptf. CO m/ma cperl/> 

The www.peri.eom Home Page 

<htt p://w w w, p erL com /> 

The Perl Institute 

<http://www, perl. 0 rg/> 

Tcl/Tk 

Tcl (the Tool Command Language) is being actively 
developed by Sun as a scripting companion to Java, 
cornplenienled by Tk (the Tool KjI) whidi provides it with a GUI, 
Tcl Is completely untyped — ''everything is a string/’ Tills may 
horrify long-time Pascal or C prcjgrammers, but it is a strength — 
it gives Td a unique flexibility and an amazingly readable style. It 
follows Perl in its level of Mac support, as Sun has a separate page 
devoted to Td/Tk for the Mac, T’hey even have a browser plugin 
which allows you to am Tcl scripts within web pages, complete 
with Tk interhices* Of course, 'Icl/Fk can readily be used in Java- 
free contexts, where it started. A great example is die popular 
sharew'are text editor Alpha, which uses Tcl as its internal scripting 
language, allowing users to custojiiize Alpha by writing Td scripts. 
For instance, you can teach Alpha to syntax-color a new language; 
this is actually an excellent way to start experimenting wath Tcl 

Sun's Overview of Td/Tk 

< http ://siJ n 5cri pt.sun .com/a bout/> 

The Macintosh Tcl/Tk Project 

< http ://su nscri pt .su n ,com/ma c/> 

Alpha Home Page 

<http ://www, id.un t-karlsru he, d e/ R utz/App I e/a Iph a ,htm l> 
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Python 

Python (named, yes, after Mont>^ Python) in many ways 
sits at the intersection of scripting and system programming 
languages. It is dynamic and object-oriented — the types of 
variable are not determined until the last possible moment 
during execution, and programmers still stinging from the 
demise of Apple’s Dylan project will l>e happy to hear that as 
in Dylan, everything in Pyihtjii is an object. It is well suited to 
nietaprogramming, easily generating executable code on the 
Oy. it is also said to excel at group projects: it's highly modular, 
scales well, and its syntax makes it easy for one programmer 
to read another's code. In almost all ways, Python is a small 
language, but it packs power — it has exceptiomhandling 
facilities and high-level data striicaires, and the latest release 
has added Perl-like regular expressions. There is even jPythan, 
a Java-based interpreter. The Python Language Home Page is 
the place to start. Also be sure to check out the SunWorld 
article Getting started %viih Python, which serves as a nice 
introduction, and then visit the Python Compared to Other 
Languages page to gain some perspective. 

The Python Language Home Page 

<http://www,python.org/> 

Jack's MaePython Page 

<http ://vyww. ewi .nl/~ ja ck/ ma tpyth D n. h t m I > 

JPython; Seamless Scripting for Java 
<http://WWW. python .org/j pyt hon /> 

Getting started with Python - SunWorld - February 199B 

<h ttp://WWW. s un xom/s on wo rldon li ne/s wo I ■ 0 2 ■ 1998/s wo I - 02 ■ py thon. htm I > 

Python Compared to Other Languages 

<http ;//www. pytii o n .or g/py th n rv/C o m pa risen s. htm I > 

Just Do IT! 

Scripting languages generate enthusiasm, and for more 
than just their power. They all reflect the personalities of their 
inventors, all are still evolving, and all are free (including the 
source code), Spend and hour or tw^o playing with one — it 
will be a pleasant experience. As you do, check out the 
following pcTSonal pages of a few Mac scripting experts, 
where you will find powerful tools as well as useful examples. 

Mizutori Tetsuya's Scripting World (AppleScript and Perl) 

<http: //www.bekko ame. or. jp/- m izutor i /scri pt/i n dex, html > 

Vince's TcLTk page 

<http ://www.f as. ha rvard. ed u/- d arley/Vir ce-Tcl Tk. htm I > 

Joe's Python Code 

<h ttp: //www-acs, l csd .ed u/ ~ jstrou t/pyt hon/i ndex, h t m l> 


Tills is an especially important month to visit our 
companion web pages at <http://www.mactech.com/onltne/>, 
where these links are supplemented by a wealth of other links 
about Perl, Tcl/Tk, and Python, as well as other programming 
resources, E 
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* 
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TIPS & 
TIDBITS 


h}f Steife Sisak 


Reducing CodeWarrior Disk Usage 

Codewarrior is a product of many 
thousands of tiny files. 

On a 2GB disk, each individual file will 
take up a minimum of 62k (even if it only 
contains a few bytes) because of the way 
HFS i)reaks up a disk. (HFS+ solves this 
problem, but until then...) 

You could reformat your liard drive and 
create a smaller partition just for Codewarrior, but there is an 
easier way: Use Disk Copy 6.13 to make a 200 MB read/write 
disk image of an empty folder (Actual size will need to be varied 
depending on what features you are installingJ 

Mount the image to the deskto]7, install Codewarrior to the 
virtual volume, and dien put the resulting image (or an alias to 
it) in your startup items folder. 

Because you are working with a smalltT virtual volume' 
your block size will be reduced to around 6k per file, saving you 
tonnes of disk space. 

Colin Foster, <cfoster@pobo.\\com> 

Wrapper for RaramText 

Many people don't seem to realize that you can't pass nil 
arguments to ParamText. Here’s a wrapper routine tliat lets you 
Ibrget about this inconvenience, as w'cil as about having to 
convert betw'een Pascab and C-string formats: 

void PaiamCText 
( 

char * PararnO. 
char *Pararal, 
char "ParamS, 
char ^Parain3 

) 

[ 

static StE255 Faram[4j i 
CcipyArE(n) \ 
if (Parainffn != nil) \ 


striicpy( (char *} Paramln]* ParaM#ili^n* 255): \ 
Param[n] [255] = 0; \ 
c 2 pstrC[ch 2 r *) Feraminl): \ 
i \ 

Else \ 

[ \ 

Parani[n] [D] =0; \ 

im 

CopyArgCO) 

CopyArgtl) 

CopyArg[2) 

CopyArg(3) 

ParaciTeKt (ParatilO] » Paramlll, Param[2] , Param[3]): 
1 rP-inutiCTcxe/ 

Just a couple of notes about die code: 


1) Tlie local “ParanC is declared static to minimize stack usage. 
But feel free to change this if you don’t like it. 

2) 1'he strings are copied Ltsing strnepy, instead of strepy. This 
way, if you pass a string longer than 255 bytes, it will be 
truncated, rather than inadvenently writing over random 
memory, strepy should probably be banned — did you know^ 
that something like 90 'Kj of of die UN[x security bugs that people 
keep finding on the Internet are caused by buffer overruns? 


Lawren ce D X)lUeiro, Ido @geek-centraLgen . nz 


TCL StrrliTM Gotcha 

Because of an obscure gotcha in the Menu Manager routine 
Setitem, TCL users implementing Other Size..." support must 
lieware. The traditional approach reserves one item on the size 
menu to dynamically display the ’other’ size, but this item has no 
logical initial value, so the temptation is to leave it empty. 

In a TCL application one uses as the text, and the #-l 
is stripped by the CBartender before it calls Setltem to install the 
text, which in lhal case would he void, wadi dire ‘unpredictable’ 
results. In.stead you can tise a lilank as a placeholder, ie 1 ”, 


Pcoui S Fnieiy, <demefy^@ieaccessjiet> 



^nd us ymr tps or wet Mall EvenBetterBusError on pur rmebine! On the other band, we might just pay pu $25 for each tip iiv use, orSSO fur Tp of ihe 
Month. You can take pur aumd in goods, suhserptions or USS. Make sure any code compiles, and send tips (and where to mail pur winnings) lo ourTips e- 
mail address at tips§niactecb.com. (Seepage 2 for our other addr&ses.) j 
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Apple Worldwide Developers Conference 

May 11 - 15, 1998 

San Jose McEnery Convention Center 
San Jose, California 


At Developer Central , you can... 

y Talk directly to representatives from Apple and third-party vendors 
> Demo developer products and tools 
Get the best deals on tools, training, and developer resource materials 



Visit the Developer Central website 

day or night for the all the latest news. 

http://www.devcentral.com 


Apple, the Apple logo. Macintosh, Mac, and the Mac OS logo are registered trademarks of Apple Computet; Inc. Developer Central, Virtual 
Developer Central are trademarks of Apple Computer, Inc. MacTech and Developer Depot are registered trademarks of Xplain Corporation. 







Wherever you are going as a developer, 
the path to success leads directly to 
Developer Central at Apple’s 
Worldwide Developers Conference ‘98. 



Think better. Think quick. Think web. 
Think fast. Think success. 


For online WWDC registration info visit; 
http://devworld.apple.coni 
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Apple *\nd Microsoft to Unify Java Technologif^ 

FOR THE Macintosh 

Will Work Together to Ease Developer Access to Native 
Mac OS Services; Improvements in Java Performance, 
Robustness Expected in Future Java Virtual Machine 

Apple Computer, Inc. and Microsoft Corp. announced plans 
to converge dieir Java teclinologies for the Macintosh to create 
a single Java virtual machine (VM) for the Mac OS. The unified 
VM will he based on Apple's Mac OS Runtime for Java (MRJ ) and 
will incorporate a variety of Microsoft technologies for Java, 
Currently, both companie.s offer Java VMs for the Mac OS. The 
companies’ cooperation on Java technology promises to 
advance the performancej robustness and functionalof Java 
support For the Macintosh and promote greater consistency For 
Java implementations across Apple Macintosh and Microsoft 
Windows operating system-based computers. 

As part of the plans, Microsoft expects to license to Apple a 
variety of technologies including aspects of .Microsoft’s J/l>irect 
API technology ft}r incorporation into MR], Tliis will allow 
software developers to create applicaiions that meld the 
productivity of tlie Java language witli tlie native capaliilitie.s of 
the Mac OS. Apple expects to incorporate this functionality into 
a future version of MKJ later this yean Once MRJ fully supports 
these technologies, Micrt)soft Internet Explorer for the Macintccsh 
will rely exclusively on MKJ as its Java virtual machine. 

The following are primary areas of ct^operation between the 
two companies: 

• JDirect harmonization. Apple will extend ihe capabilities of its 
JDircct technology by incoiporating apJ:^licable features of 
Microsoft J/Direel tf) enhance native language access and 
provide consistency lor development tools. JDirect gives Java 
developers direct, high-performance acces.s to native 
Macinto.sh system services such QuickDraw, AppleEvents, 
contexlLial menus, drag and drop, and TnieType fonts, 

• Seettriry^ Zones. The companies will integrate the Microsoft 
.security administration technology lor Java with other 
Internet security options to provide a simple and consistent 
model for managing security preferences. 

• Debugging, llie companies will integrate the Microsoft VM 
debugging AEI into MRJ, exposing a rich and consistent set of 
debugging capabilities to Java development tools like 
Metrowerks' CodeWarrior. This API wall also suppon 
debugging across languages, allowing developers to build 
applicaiions using multiple programming languages 

• Compatibility te.st suites. The companies will exchange their 
internal compatibility test suites to facilitate consistency and 
compatibility with real-world Java applications. 


AppiJt Brlngs QuickTime to Java 

It's been rumored for a w^hile, and now Apple has 
announced the availability of QuickTime for Java. QT for Java is 
a developer framework for easily adding multimedia playback, 
authoring and publishing capabilities to Java softw^are. 
QuickTime for Java wall significantly increase Java’s acceptance 
in new media markets and enable delivery of compelling 
interactive content to Java customers. 

QuickTime for Java allows developers to write Java 
programs that incorporate QuickTime content and functionality. 
Java developers will now have unlimilcd access to QuickTime's 
rich support for digital media, including graphics^ sound, video, 
text, music, VH and 3D. Additionally, they wall be able to 
deliver high-c|uality video and audio using QuickTime 3’s 
compression rechnologies, which ensure outstanding fidelity 
even at low bit-rates. 

A developer release of QuickTime for Java is now' avaUable, 
For information on how' to get the softwaire, visit the QuickTime 
w'cbsite at <http://www.apple.com/qu:icktirrie>. 

FileMaker, Inc, Announces FileMaker Pro 4.0 
Df,wloper Edition 

Powerful developer’s tool for rapid solution development 
and deployment 

FileMaker Inc., formerly Claris Carp., announced FileMaker 
ITo 4.0 Developer Edition, an essential database development 
i(K)l kit for corporate and professional developers that ruas on 
Window's 9 ^^, Windows N^f and the Mac OS. 

FileMaker Pro 4.0 Developer Edition will provide developers 
with a wide array of 32-bit based applications and tools for 
compiling, debugging, devckjping, deploying and managing 
FileMaker Pro database sc^lutioos, the company said. 

For the first time ever, the new version, scheduled to ship 
later this year, will feature an API (Application Program Interface) 
that will allow' developeis ro write External Functions for 
FileMaker Pro databases, a capability that will greatly expand the 
core functionality found with the standalone version of FileMaker 
Pro 4.0, the company's aw'ard-winning desktop database 
software application. In addition, FileMaker Pro Developer 
Edition will also enable access to FileMaker Pro databases over 
Java compliant operating systems^ such as Unix and Solaris 
Systems, with the addition of Java classes. 

<http://www.clarisxom> 

<htTp://www.filemaker,corTi> 
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There are more and innre reasons Stufflt i 
WB InslallerMaker 4.f) is the Complete Inst allation 1 
Wr Solution. Now your installer can automatically a 
retrieve files from an FTP site, so youi' users always gel - 
the right software. 

Stuff! 1. InstallerMaker 4*6 picks up where your 
compiler stops* It allov\^ ytm to easily create 
custom installers for distributing software or j 
tiles. Using our installer reduces technical | 
» support, calls due to end-user errors during i 
installation, saves disks (if distributing on floppies) 
or download time (if distributing on-line). 

Download a I rPP. fnlly-fnnctional copy of Stufflt 
InstallerMaker 4.6 from www.aladdiiisys*coin, or 
(sail (408) 761-6200 and ask for Developer Sales* 


© 1998 Aladdin Sysle^ns, Inc. les Westndge Dmiii, Watsonville, CA 95076 Fax: (408) 7S1-6206. 
internet ctev.sales@alacktinsy 5 .com. Siufflt InslalterMaker is a kademark ot AlackJin Systems, Inc 
Other prockjcts are trademarks df their respective holders. 





THE 

CLASSIFIEDS 


SERVICES 


The Law Office of Bradley M. Sniderman 

California Lawyer focusing on Intellectual Property, 
Corporate, Commercial and Contract law, as well as 
Wills and Trusts. 

If you are looking to protect your software with 
Copyright or Trademark protection, or if you need help 
establishing or maintaining your business, please give 
me a call or an e-mail. Reasonable fees. 

(31 Oy 553-4054 

brad@sniderman.coiii 


Visit MacTech* M^azine’s Web site! 

http://www.mactech.com 


Professional Software Developers 

Looking for career opportunities? 
Check out our website! 

Nationwide Service 
Employment Assistance 
Resume Help 
Marketability Assessment 
Never a fee 

Scientific Placement, Inc. 

800-231 -5920 800-757-9003 (Fax) 

das @ sc ientific .com 



Wan 


I 


The fastest, cost effective way to get product off your shelves. 


For information: • Voice: 805/494-9797 • Fox; 805/494-9798 • E-mail: venclor_relations@devdepot.com 
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If you want to be in the know, then you 
need every article published in the first 
12 years of MadTech® Magazine and 
Apple’s develop” issues 1-29! 

...in THINK Reference-fornuiU _ 


So hurry, pick up the phone, fire up 
the e-mail, launch that fax machine, 
or simply drop by our web site and 
order yourself this new release of 
the MacTech* CD-ROM. 


Almost 1600 articles from all 139 issues of 
MacTech Magazine (1984-1996) 

Includes Apple develop issues 1-29 

Improved hypertext, improved indices, and a new THINK 
Reference Viewer — for lightning quick access! 


New hyperlinks between articles 

100-H MB of source code — use them in your applications, with no royalties! 

Full version of THINK Reference — the original online guide to Inside 
Macintosh, Vols. I-Vl 


80MB of FrameWorks/SFA archives and the most complete set of Frame Works 
archives known 


Sprocket™! MacTech's tiny framework that compiles quickly and supports 
System 7.5 features 

The best tlireads from the Mac programmer newsgroups plus thousands 
of notes, tips, snippets, and gotchas 


Popular tools that Mac programmers use to increase tlieir productivity and 
much more! 



Web Site: http//www.devdepot.com • E-mail: orders@devdepot.com 

Phone: 800-MACDEV-l • Outside the U.S. & Canada: 805-494-9797 • Fax: 805494-9798 


MacTech is a registared trademafk of Xplain Corporation. MacDeV’t , THINK Reference, Developer Depot, Sprocket, JavaTech, WebTech, BeTech, and the MacTulorMan 
are traderriarks of Xplain Corporation. Other trademarks and copyrights appearing in this printing or software remain the property of their respective holders. 
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E-mail: orders@dcvdepot.com • Web Site: http://www.devdepot.com 



. ^ 1 1L__ 

^ ^ World renowned 



customer service 

Order by phone, 
E-mail, fax or through 
our continually 
updated Web site 




Hundreds of 
develpper products 

Satisfaction 
and lowest price 
guaranteed 




















Developer To Do List: 

l^Prioritixe proiert •'»* * ** 

□ Pick up new MocTech CD- 

□ Check out all the Dev De^ 
i-h T II »k« aana about Dev Depot deals 

□ Enter Dev Depot info into con 
Deveioper Depot 

PO Box 5200 oi'»W-5200 

Westlake Village, CA 91359 5 

Voice: ' 005 / 494.9797 

Outside us/Canada: 805/49A v/ 

fax- 805/494-9798 

E Wil; orders@devdepot.com 
h«p://www.devdepot.com 
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Don't Forgetto Visit Us 
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AT 

Apple's Worldwide 
Developers Conference 



May 11 


15, 1998 



San Jose Convention Center 

San Jose, California 
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Developer Depot 50 day Money Rack, Price and 
Satisfaction Guarantee 

i)eveloper Depot products are sold with a 30 Day money back guarantee on 
user satisfaction, lower prices and against defects. If, for any reason, you are 
not satisfied or find the same prtxluct at a lower price within 30 days, please 
call Customer Service at 800-MACDEV-l and request a Reaim Merchandise 
Authorization (RMA) number to get a full refund or the difference in price 
(where applicable). You must return undamaged puxlua ai your expense, 
including all its original packaging, documeniati<jn and the blank warranty 


card if applicable. Developer Depot will replace defective prcxluct upon 
receipt of the defective merchandise. Please remember to back up ytjur data 
before iastaOation of any new hardware, softw^are, or peripherals; we cannot 
lie responsible for any lost data. Policies, item availability, and prices are sub¬ 
ject to change without notice. Hie price in effect when we receive your order 
will be the price dtat you are diatged. We are not responsible for any typt>- 
graphical errors in this or any other catalog, nor for any misstatements from 
any vendor. Purchase orders are not accepted w ithout prior approval Qrll for 
more information. 


Stuff our lawyer niade us write. 

Developer Depot makes no other warranties. All mher warranties, either expressed or implied, including the implied warranty of merchantability and fitness for a panicnjlar purpose 
are disdaimeef. l.leveloner Depfjt sliaJl ntX Tic liahk* for any direct, special, intidenial or consequential dam^es including lost profits, from any delay in delivery, or for any person¬ 
al iniur>' arising from the use of any product Kild through Developer Depot The limit of direct damages, ii any, shall ncX exceed tlic purchase price of the product.© 1997 Xplain 
Corporal ion. All rights reseived. Any unauthoriv:ed duplication is in violation of federal laws. Developer Depot is a registered trademark of Xplain Corporation. All prcxluct names in 
tltis catalog are the trademarks of their respective holders. 

© 1997 Xplain Clorporation. All rights reserved. Any unauthorized duplication is In violation of federal laws. Developer Depot ts a trademark of Xplain Cxirpomtion. All product names 
in this catalogue are trademarks or registered trademark!^ of their respeaive holders 
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CodeWaniOT 


metrowerks 


CodeWarrior for 
PaImPilot 
Release 4 

by Metrowerks 

CodeWarrior for PaImPitot 
is the first complete set of 
tools which enables you to 
develop for the U.S. 

Robotics PaImPilot 
connected organizer, from 
the comfort of your PC or Macintosh computer. All the tools you 
need are included: the award-winning CodeWarrior IDE, 
compiler, linker, source-level debugger, GUI builder, and other 
tools, plus online documentation and reference materials. 
Includes one free product update and free technical support 
with registration. 

(SCWPALM) Our Price $369 


cnecK out our weo site! 

• Full product descriptions • Hundreds of more products 

http://www.devdepot.coin 


CodeWarrior 

Latitude 

by Metrowerks 



Don’t throw away the 
investment you have made 
in your Mac OS application! 

With the new DR2 release 
of CodeWarrior Latitude, you 
can now port your Mac OS 
application to Rhapsody, as 
well as Silicon Graphics IRIX 
and Sun Solaris. At the 
heart of Latitude is a set of shared libraries which performs the 
functions of the Macintosh API. You recompile your Mac OS source 
code, linking it with the Latitude libraries to produce a native 
application, As the Rhapsody API evolves, so will Latitude. 
Registered users of CodeWarrior Latitude will receive all developer 
releases, the first full release, plus one additional product update, 
to ensure that you have access to the most up-to-date Rhapsody 
porting tools available. 


(SCWUT) Our Price $399 




by Metrowerks 


• Start programming for the new, innovative Be Operating 
System (BeOS) with complete set of Codewarrior tools 

• BeOS-native Integrated Development Environment (IDE) with all 
the familiar CodeWarrior features at your fingertips 

• A BeOS PowerPC compiler and linker, an editor w/syntax color 
and styling, and a source-level debugger 

• BeOS header and libraries, complete documentation, useful 
C-i-r- classes, and sample code 

• Now includes Java support 

• The BeOS Preview Release allows you to run and program for 
the BeOS on a 603 or 604 PCI based PowerMac 

(SCWFB) Our Price $299 



MW Visual 
SourceSafe 


Release 5 

by Metrowerks 


Source code control 
system, plug-in to the 
CodeWarrior IDE or 
stand-alone Client 
application 

Compatible with Microsoft Visual SourceSafe version 5.0 
Cross-platform support (Mac, Windows, UNIX) 

Configuration management in excess of 4 billion files 
Over 8,000 files and sub-projects in a single sub-project 
Registered users receive one year of free technical support 
and one free update 
(SMWVSS) Our Price $499 
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CodeWarrior 
Discover 
Programming 
Edition 

by Metrowerks 

• Learn to program in 
C/C++/Java/Pascal 

• Full-featured programming product-not a lite" edition 

• Online books and tutorials 

• Flosted on either Mac OS or Windows 95/tJT 
CodeWarrior Discover Programming Edition offers an unbeatable 
combination of full-featured programming tools, online books 
and instructional materials, all at a great price. Whether you 
want to learn the basics of programming or add a new language 
to your skill set, Discover Programming puts the information and 
tools you need at your fingertips: the award-winning, easy-to- 
use CodeWarrior Integrated Development Environment (IDE), 
four of the most popular programming languages, online books, 
online tutorials, sample source code and free technical support 
(with your registration). Discover what you can learn with 
CodeWarrior, buy your copy today! 

(SDPED) Our Price $79 


Pro Fortran 

by Absoft Corporation 

Absoft Pro Fortran combines native F90, VAX compatible F77, md 
C/C-H- compilers into a single, easy to use environment. All compilers 
are link compatible and operate through a common Interface. 

• Graphical debugger, browsers, array display, performance profiler, 
linker, MRWE application mainframe 

• MIG graphics library, Absoft Create Make, several utilities, the 
latest version of MPW and illustrated documentation 

• Whole array operations, modules, interface blocks, and user- 
defined types or data structures 

• Dynamic memory allocation and new control constructs 

• F90 is link compatible with Absoft F77, C-i-i-, MrC and 
CodeWarrior 

• It is fully compatible with Toolbox, MPW tools, and most third- 
party products 

(SAPROF) Our Price $899 







CodeWarrior 
Professional Release 2 

by Metrowerks 

• Includes Windows 95/NT and Mac 
OS versions of the CodeWarrior IDE 

> Supports C, C-I-I-, Java and Pascal 

' Develop for Windows DS/kfT on x86 and Mac OS on 68KA^owerPC 

> V2 Project Manager supports multiple open projects, subprojects, 
multiple targets per project, and threaded execution 

' Support for JOK 1.1.3 in CodeWarrior Java 
More platforms, more languages, more options: CodeWarrior 
Professional is designed to give you the tools you need for serious, 
industrial-strength programming, CodeWarrior Professional is the 
only Integrated Development Environment (IDE) in which you can 
edit, compile and debug C, C++, Java and Pascal programs for 
multiple target processors and operating systems. CodeWamior’s 
compilers produce fast, highly optimized code for Windows 95/NT 
running on x86, or Mac OS running on 68K or PowerPC prooessors. 
CodeWarrior Professional features the CodeWarrior IDE Version 2. 
The revamped Project Manager supports multiple projects open 
simultaneously, multiple targets per project, and threaded execution, 
and it's significantly faster. CodeWarrior Professional also includes 
online books, documentation, and reference materials, as well as 
tutorials and sample code. We support 
your development efforts with one free update and free world- 
class technical support for a year with registration. 

(SCWPR02) Our Price $449 



BeOS Preview 
Release 2 

by Be, Inc. 

As the Internet spreads and 
electronic media becomes more 
prevalent, the high-performance 
needs of digital content design and 
the complex, aging architectures of 
current mainstream operating 


systems are coming into conflict. The BeOS is the first operating 
system designed to unlock the door to much more powerful 
personal computers, and extract more performance from the 
systems we use today, 

(SBEOS) Our Price $49 
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Macintosh Common Lisp 4.0 

by Digitool, Inc. 

Macintosh Common Usp provides users 
with a rich set of object-oriented dynamic 
language features making it especially 
well-suited for rapid protot^ing, custom 
development for business and education, 
scientific and engineering applications, 
and academic research. 


• Power PC native environment & compiler, full Macintosh support 

• CLOS, the standard Common Lisp object system 

• Interactive dynamic environment, multiple processes 

• Automatic memory management and self-typing data 

• Ephemeral garbage collector, smaller application footprint 

• Compiles with Common Lisp industry standard and smart 
programmable tools, 110+ mb of user contributed code 

• Complete on-line documentation (manual sold separately) 

• Software license and registration card 
(SMCLISP) Our Price $675 


I 
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visual Cafe for Java 
Professional 
Development Edition 

by Symantec 

• Powerful Java and JavaBeans IDE 
with Plug-and-Play JavaBeans 
functionality 

• 100-1- Professional, Reusable 
JavaBeans Components with Source Code 

Full JDK 1,1 Support via MRJ 2.0 
Latest Java Foundation Class (JFC) Library 
Comprehensive source editor with color coding and keyword 
highlighting 

On-the-fly Class reusability 

Turn Auto Code Generation On/Off Environment (RRAD On/Off) 
Powerful debugging Tools including debugging in any 
application running MRJ 2.0 and breakpoint view 
Netscape communicator 4.0 
Full featured Visual Page HTML Authoring Tool 
(SVCJAVA) Our Price $299 





MkUnux: Microkernel Linux 
for the Power Macintosh 

by Prime Time Freeware 

MkUnux is a native port of Mach 3 and the 
Linux 2.0 kernel, complemented by 
hundreds of commands from BSD, GNU, and 
X11, It runs on most (NuBus and PCI bus) 
Power Macintosh systems; Performa, 
PowerBook, and multiprocessor ports are currently under 
development. 

MkUnux is robust, powerful, freely distributable, and source code 
compatible with most other Linux systems. It provides a full suite of 
development tools, support for AppleTalk, HFS, and Objective-C, and 
access to a vast amount of free software. MkLinux is a great way to 
"come up to speed" on Mach, UNIX, and Rhapsody. 

• MkLinux user community supports RP and web servers, 
development and porting efforts, and several mailing lists 

• The Apple sponsored reference release contains a wealth of 
introductory and reference material on Linux, Mach, NeXT, and the 
Power Macintosh 

• Includes free 3.0 upgrade 
(BMKLiNUX) Our Price $49 


Visual Cafe for Java 
Database 

Development Edition 

by Symantec 

• FileMaker Pro and BlueWorld Lasso 
trialware versions 

• 100+Database aware JavaBeans 
Sybase SQL 

• Anywhere server-side database with development and runtime 
engines for Win95/NT 

• DbANYWHERE server-side server 100% JDBC middleware 
with native drivers for Informix, Sybase, Oracle and Microsoft 
SQL server 

• Support for over 30+ databases through ODBC 

• Swift and scalable data access with dbANYWHERE’s true three 
tier architecture 

• Netscape Fast Track Web Server (Win 95) 

• Netscape Communicator 4.0 
(SVCJDB) Our Price $499 



VIP-BASIC: 

Visual Interactive 
Programming in BASIC 

by Mainstay 

Now you can create full-featured, stand-alone 

Macintosh and Power Macintosh applications in standard BASIC code! 

VIP-BASIC 2.0 is the fastest way to program your Macintosh. 

• Rapid application development environment with application 
framework, mix and match: VIP-BASIC high-level subprograms 

• Import pre-existing BASIC code: automatically integrate BASIC 
code, export C Code tor compiling: automatically convert your 
BASIC code to C for compilation with Metrowerks' CodeWarrior 
(SVIPBASIC) Our Price $195 


VIP-C: 

Visual Interactive 
Programming in C 

by Mainstay 

Now you can create full-featured, stand¬ 
alone Macintosh and Power Macintosh applications in just minutes. 
VIP-C 2.0 is the first rapid application development system for 
creating complete Macintosh programs in standard ANSI C, 





Order Toll-free 
800-MACDEV-1 


• Includes powerful, tightly integrated visual debugger, Import pre¬ 
existing C code: automafically integrate C code with a current project 

• Includes full-featured mini database: (itd to 32K) of the powerful 
VIP-BASIC database manager gives you everything you need to 
setup royalty-free, multi-user database applications 

(SVIPC) Our Price $295 
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/fff INTERSYSTEMS 


CodeBuilder 

by Tenon Intersystems 

CodeBuilder is a powerfui and unique Macintosh software 

development tool for porting existing apps or deveioping new, 

advanced appiications on Power Macs and Power Mac clones. 

• A powerful Macintosh software development tool suite of C, 
C++, Objective-C, Java, Ada, and Fortran deveiopment toois 

• Compiete UNIX & X deveiopment environment for developing 
UNiX or Macintosh apps 

• includes compilers and source-code debugger for Objective C, 
and C, C++, Ada 95 and Fortran 77 

• Web & internet scripting tools: Peri, MacPerl, tcl/tk, bash, sh, 
and csh 

• Supports Rhapsody kernei APis and Rhapsody TCP sockets 
(SMiOCODEB) Our Price $149 


SmalltalkAgents for Macintosh 

by Quasar Knowledge Systems, Inc. 

• An Integrated Development Environment (IDE) based on QKS 
Smalltalk, 

• "Live" direct manipulation of your objects 

• Dynamic, interactive and iterative deveiopment process 

• Easy and full access to the features of the Mac OSftm) and Mac 
Toolbox 

• Link your non-Smalltalk code fragments with Code Fragment 
Manager (CFM) support 

• Cross-reference, access, view, and manipulate your code and 
objects with a sophisticated database for source code 
management 

• Includes an Application Delivery Toolkit(tm) (ADT) that allows you 
to create royalty-free, standalone, double-clickable applications 
(SSTA) Our Price $395 


Check out our Web site! 

• Full product descriptions • Hundreds of more products 

http://www.devdepot.com 


NS BASiC 3.6 
for Bie Newton with 
Visual Designer 

by NS BASIC Corporation 

• A fully Interactive implementation 
of BASIC programming language 

• Runs entirely on the Newton - no 
host Is required 

• Create files, access the built in soups, and the serial port for 
input and output 

• Work directly on the Newton, or through a connected Mac/PC 
and keyboard 

• Get the BASIC Internet Tool, available at no charge to NS BASIC users 
from www.nsbasic.com 

• Release Notes with sample code are available from the same location 

• Runs on any Newton MessagePad 130 with NS BASIC and the 
Nevrton Internet Enabler. Also runs on MP1201s with NOS 2.0 ttiat 
have full memory available 

• Write short programs to access News, mail and the web 
(SNSBASIC) Our Price $99 



ObjectMaster 
Professionai Edition 

by Altura Software, Inc. 

Object Master ts an innovative programming environment that 
provides all the necessary tools to write, organize, and navigate 
through source code. 

• Write code using the most robust source code editor available 
on the desktop 

• Organize source code into projects to quickly access and 
manipulate all files 

• Navigate through source code using intuitive graphical 
Browser windows 

(SOMPE) Our Price $399 



Here's a list of all available products. For full product descriptions 
please see our Web site, or feel free to call, fax, or E-mail us. 


PRODUCT 

CODE 

OUR PRICE 

LPA MacProlog Developers Edition 

SLPAO 

995.00 

LPA MacProlog Programmers Edition 

SLPAP 

495.00 

LS Fortran Pro 

SLSFORT 

595.00 

LS Fortran Plug-In 

SLSFPI 

199.00 

Mac FORTRAN II 

SF0RT2 

595.00 

Power MachTen-TJNIX 

SM10PPC 

695.00 

Presenting Magic Cap 

BPRESMAGiC 

15.25 

Think Pascal 4.0 

SPASCAL 

165.00 


V 

V 
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NetMeter** 

by AG Group, Inc. 

NetMeter traffic monitoring modules provide an instantaneous 
view of how a local or wide-area network is presently 
behaving. By using the industry standard Simple Network 
Management Protocol (SNMP), NetMeter offers network 
managers a convenient way to monitor live traffic statistics 
from any local or remote SNMP-capable device such as Internet routers, servers and 
hubs. Using a wide variety of realtime meter modules, select any interface of a local or 
remote SNMP capable device and confinuously monitor utilization, errors and broadcasts 
either transmitted or received by the device. 

NetMeter (SNCTSM) Our Price $295 

NetMeter with Satellite (SNET) Our Pirce $395 





Skyline™/Satellite 

by AG Group, Inc. 

Skyline/Satellite is a multi-segment Ethernet traffic archiving, 
alert and analysis system designed to monitor, tune and 
optimize heterogenous networks. With a broad, rich set of 
display, reporting and alert options. Skyline (with one or more 
Satellites) identifies precursors to network problems, pinpoints 
configuration bottlenecks, tracks peak traffic times and loads, 
quantifies bandwidth usage, as well as measures server and router performance. Find 
under-utilized network segments, overloaded servers, bandwidth abusers and more. 

• Monitor the “pulse" of local or remote Ethernet segments 

• “Baseline” network activity 

• Provide usage reports on parameters you specify 

• dentify configuration issues and possible solutions 
(SSKY) Our Price $795 



^teDiicr! 



EtheriPeek^*^ for Macintosh: 

by The AG Group, Inc. 

EtherPeek is an award-winning Ethernet 
network traffic and protocol analyzer 
designed to make the complex tasks of 
troubleshooting and debugging mixed- 
platform, multi-protocol networks easy. 
EtherPeek sets the industry standard for 
ease-of-use while offering all the superior 
diagnostic and analysis capabilities expected 
of a full-featured analyzer. 

• Automatic IP and AppleTalk name-to- 
address mapping 

• Powerful decoding with support for ail major 
protocol suites (including IP, AppleTalk, 
Netware IPX/SPX, NetBEUI, NetBIOS, 

DECnet, SMB, OSITARP and more) 

• Real-time and post-capture packet filtering 

• ProtoSpecs” technology for fine 
delineation of packet type 

• Plug-in modules for expert packet analysis 
(SEPEEK) Our Price $995 


AAA 
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Joy Explorer 

by AAA-h Software 

Joy Explorer gets you started with 

Rhapsody programming quickly: 

• Step by step tutorial for implementing 
simple applications 

• Graphical application inspector for 
inspecting classes, Instances, methods, 
and data structures inside any 
Rhapsody application. 

• Interactive sending of messages to objects 

• Extension to Rhapsody’s Interface 
Builder which permits 
Implementation of prototypes right 
within Interface Builder - no need to use 
any tools except Interface Builder; no 
need to compile and link. 

• Example programs with full source code, 
including source code for application 
Inspector, 

(SJOYEX) Our Price $69 


Joy Developer 

by AAA-i- Software 

Joy Developer is an essential tool for anyone serious about developing for Rhapsody; 

• Rapid application development right within Rhapsody’s Interface Builder 

• Incremental extension of existing applications (test-fix-go) without any need to recompile, relink 
or restart the application 

• Turn interface files into standalone applications that run on any Yellow Box platform simply by 
using the new "Save Nib As App" command In Interface Builder 

• Mix-and-match interpreted scripts and compiled code freely; anything you can do in compiled 
Objective-C and Java can be done in Joy - and more. 

• Full support for all Objective-C classes, typedefs, macros, data structures, exceptions, Tcl 
8.0 commands and extensions, including byte-code compiler to boost performance 
(SJOYDEV) Our Price $399 

Web Ware 

by BeachWare, Inc. 

The ultimate collection of clip media and templates for building your 
own Web Page. An incredible selection of Shockwave movies, 
animated GIFs, buttons, bullets, dividers, and sample HTML pages. 
There are literally thousands of graphical elements on this disc, all 
there to spice up your web page. In all, it's about 300 megabytes of creativity only a mouse- 
click away! System Requirements; PC - 486 or better with 8 MB RAM, Sound card, 
SuperVGA, CD-ROM drive. Macintosh - Color Mac with 8 MB RAM, CD-ROM drive. 

(SWEBW) Our Price $24 
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Visual MacStandardBasic 3.0 

by ZCurve Software 

Visual MacStandardBasic is the new standard for creating both 

68K and Power Macintosh applications. 

• Applications can be visually created in minutes 

• Visual controls such as command buttons, text boxes, list 
boxes, radio buttons, check boxes, scrollbars, icons, pictures 
and timers can be created and modified instantly 

• Lise color graphics, animations, movies, sounds and speech 
in your programs 

• Console text window option helps converting older BASIC 
source code from other platforms 

• Online tutorial, manuais, sample projects get you programming quickly 

(SVMACSB) Our Price $29.95 


QC 

by Onyx Technology, Inc. 

High performance runtime stress testing for 

applications. 

• Tests include heap checks, purges, scrambles, 
handle/pointer validation, dispose/release checks, write 
to zero, de-reference zero as well as other tests like 
free memory invalidation and block bounds checking 

• Extremely user friendly - ideal for non-programmer 
testers 

• Aiso available in Japanese 
(SQC) Our Price $99 



PowerKey Pro Model 200 

by Sophisticated Circuits 

PowerKey Pro Model 200 lets you start 
up and shut down your Mac and up to 
five peripherals with a 
single keystroke. Two 
groups of switched 
outlets let you control 
some peripherals 
separately. PowerKey 
also features phone 
ring startup which 
lets you access your 
Mac while on 
the road. 

Powerful scheduling 
features let you 
control your outlets with “hot keys” or 
perform tasks unattended. Start up your 
computer at any time of the day or night, 
open applications and run AppleScripts 
or QuicKeys. Add the optional Server 
Restart Option and you can even restart 
crashed servers automatically! 

System Requirements: Mac with ADB 
port. System 7 or later. Telephone 
features require analog phone line. 
(HPKEY2) Our Price $99 


PowerKey Pro Model 600 

by Sophisticated Circuits 

PowerKey Pro Model 600 is “the world's 
smartest power strip!" Start up and shut down 
your Mac and 
peripherals with a single 
keystroke. Includes six 
individually-switched 
outlets, witti manual 
switches and indicator 
lights. Powerful 
scheduling features let 
you control outlets with 
“hot keys" or perform 
tasks unattended. Start 
up your computer at any 
time of the day or night, 
open ^plications and run AppleScripts or 

■ QuicKeys. Complete telephone controllability 

■ lets you start up the computer, switch outlets 
or run complex events using custom touch- 

; tone commands. For a limited time, Model 600 
includes the Server Restart Option, Restart 
crashed servers automaticaliy! 

System Requirements: Mac with ADB port, 
System 7 or later. Telephone features require 
analog phone line. 

(HPKEY6) Our Price $199 




PrimeBase RDBMS 

by Snap Innovation 



Industrial Strength, Multipiatform 

Client/server RDBMS (relational database 

management system) 

• Easy to install, and easy to maintain 

• Server and client available on: MacOS, 
Rhapsody/OpenStep, Windows95/NT, 
Linux, Solaris, AIX 

• Interfaces: ODBC, DAL, Metrowerks 
PowerPlant, 4D, EOF 

• Single User Runtime available 

• CGi / Application Server available, using 
embedded DAL 

Developer License 
(SPBASDEV) Our Price $50 

Production License 
(SPBASVR) Our Price $820 

(The Production License includes 10 
connections MacOS, Rhapsody or 
Windows95/NT] 




SpotCheck 

by GenieWorks, LLC 


SpotCheck is a language-based editor that 
“knows" the Java language. It is designed to 
help a Java programmer produce correct code 
without relying on confusing and untimely 
feedback from a compiler. Specifically, 
SpotCheck identifies syntax errors and 
semantic errors (undefined names, type 
mismatches, etc,] those errors normally 
returned by a compiler. This analysis is 
performed after each edit, giving the 
programmer immediate feedback on errors. 
SpotCheck provides a host of additional 
features, including: 

• smart links to name declarations 

• cross-referenced Java APIs 

• editing with popup menus 

• interfaces to helper apps to compile & run 

• hierarchical project browsing 

• color-coded syntax 
(SCHK) Our Price $59 
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OpenGL for 
the Macintosh 

by Conix Graphics 

OpenGL is the premier 3D graphics library that allows software 
developers the ability to develop high-quality, interactive 2D and 3D 
graphics applications. OpenGL can perform the following wide range of 
functions which will enhance the development of all graphics software: 

• Geometric primitives (points, lines, and polygons) 

• RGBA or color index mode 

• Viewing and modeling transformations 

• Texture Mapping, Lighting, Shading and Z Buffering 

• Atmospheric Effects (fog, smoke, and haze) 

• Alpha Blending (transparency) 

• Antialiasing, Accumulation Buffer, Stencil Planes 

• Display list or immediate mode 

• Polynomial Evaluators (to support Non-uniform rational B-sp!ines) 

• Eeedback, Selection, and Picking Raster primitives (bitmaps and 
pixel rectangles) 

• Pixel Operations (storing, transforming, mapping, zooming) 
(SOPENGL) Our Price $389 
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Guide Composef" 1.2 

by StepUp Software 

• Create powerful Apple Guide help systems for any new or 
existing Macintosh application 

• Provides a WYSIW/YG development environment: Guide content 
is developed in Guide windows 

• Design topics, phrases, and panels in the same format as the 
user will use them 

• Eeatures are WYSIWYG interface. Topics, phrases, and 
hierarchical phrases, Coach marks, Fully-integrated with Apple’s 
Guide Maker (distributed with Guide Composer), compiles scripts 
automafcally, PICTs in Panels, Generated Guide scripts are 
modifiable 

• FREE Update to all registered Guide Composer users. Demo is 
available at http://www.guideworks.com/ 

(SGCOMP) Our Price $99 

SEE RELATED PRODUCTS: AppleGuide Complete, Danny Goodman's 

AppleGuide Starter Kit, Real World AppleGulde 

SciiptGen Pro 

by StepUp Software 

• Installer script generator which requires no programming or 
knowledge of Rez 

• Supports StepUp’s InstallerPack, Stuffit decompression. 
Compact Pro decompression, custom packages, splash 
screens, network installs, and resource installation 
(SSCRPTGEN) 0urPrice$169 
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ObjectSet Mail SDK 

by Smartcode Software 

• Powerful C+-I- classes for 
integrating Internet e-mail in your 
applications 

• Helps you write software that can 
share mail with other leading 
e-mail products 

• . Royalty-free MIME, SMTP, and 
POP3 APIs for Macintosh, Windows, and Unix 
Gives you the most robust MIME parser and encoder available 
Ideal for use in Internet and Intranet environments 
Comes complete with samples with documented, reusable 
source code 

Free standard technical support 


tJet-lnuiM! 
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(SOSMSDK) Our Price $495 





BBEdit 4.5 

by Bare Bones Software 

BBEdit 4.5 is a powerful, easy-to- 
learn text and HTML editor that 
I ^ offers developers and HTML 

I BBEdit 4,5 authors the ability to build on its 
core functionality to suite their 
specific needs through its plug-in architecture and scripting 
capabilites, This new version includes: a visual table tool that 
speeds page and site development, contextual menu support for 
Mac OS 8, improved storage for ‘grep’ patterns, scriptable HTML 
authoring preferences and more. It still provides: unparalleled 
searching muscle with support for both ‘grep’ style and advanced 
literal searches, the ability to quickly compare differences 
between files or entire folders, integrated support for Symantec’s 
IDE, Metrowerks CodeWarrior, THINK Reference 2,x, MPW 
Toolserver and most other environments and a heck of a lot more. 
(SBBEDIT) Our Price $119 
Also see Internet Related, page 12 


CodeBuilder An ^TEKON 

by Tenon Intersystems rwreRSYSTEMs 

CodeBuilder is a powerful and unique Macintosh software 

development tool for porting existing apps or developing new, 

advanced applications on Power Macs and Power Mac clones. 

• A powerful Macintosh software development tool suite of C, C-f+, 
Objective-C, Java, Ada, and Fortran development tools. 

• Complete UNIX & X development environment for developing UNIX 
or Macintosh apps 

• Includes compilers and source-code debugger for Objective C, and 
C, C-E-i-, Ada 95 and Fortran 77 

• Web & internet scripting tools: Perl, MacPerl, tcl/tk, bash, sh, 
and csh 

• Supports Rhapsody kernel APIs and Rhapsody TCP sockets 
(SMIOCODEB) Our Price $149 
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AppMaker 

by Bowers Development 

• Develop the user interface for a Macintosh application 
using the original interface builder 

• Just point and click to design your application 

■ Creates resources and generates excellent source code 

• Supports most development environments including 
Metrowerks, Symantec, or MPW; C, C++, or Pascal; 
procedural or object-oriented, using PowerPlant, TCL, 
or MacApp 


• The generated code uses the Universal Headers to provide PowerMac compatibility 

• Great tool for beginners to learn object-oriented and Macintosh Toolbox programming 
techniques 

• Includes one-year subscription on CD and hardcopy documentation 
(SAPPMAKE) Our Price $199 


Water's Edge Software 



Tools Plus libraries + 
framewoik 

by Water's Edge Software 

Easily create compact, fast running, 
professional looking applications and plug-ins*. 
Tools Plus lets you create virtually any user 
interface element with a single routine, and it 
transparently provides a robust infrastructure to 
make ail your pieces work together as an 
application. 

• Simplifies programming and thins source 
code 

• Automates all standard GUI elements 

• Thousands of extras, from floating palettes 
and tool bars to powerful picture buttons 

• Includes numerous 3D grayscale options 


• Over 1/2 MB of custom fonts, icons, 
cursors, and other resources 

• Includes SuperCDEFs world-class controls 
(an $89 value) free 

(STOOLCW) Our Price $249 

CodeWarrior Gold 

(C/C++ & Pascal, 68K & PPC) 

(STOOLCWB) Our Price $199 
CodeWarrior Bronze (C/C++ & Pascal, 681^ 

(STOOLSYMT) Our Price $199 
Symantec (THINK) C/C++ and THINK 
Pascal {68K) 

(STOOLSYM) Our Price $149 
Symantec (THINK) C/C++ (68K) 

(STOOLPAS) Our Price $149 
THINK Pascal (68K) 

‘CodeWarrior required to write plug-ins 
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TesYh'ack-Bug Ikracking 
the Macintosh Way 

by Seapine Software, Inc. 

• Tracks bugs, feature requests, test 
configurations, users, and more 

• Includes notifications, security, a 
powerful filter mechanism, and 
multiple reports 

• Links your testers, engineers, 
documentations staff, and project 
managers together to ensure all bugs 
are identified, fixed, and documented 

• Eliminates the need to build custom 
bug tracking solutions using general 
putpose database tools 

• Supports single- and multi-user bug 
databases (additional licenses 
required to use multi-user features) 
(STETR) Our Price $169 
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BeSpectfic 3 

(Third in a series) 

by Adamation 

The best-selling BeSpecific CDROM series 
provides the best in BeOS 
shareware across a wide range of 
application areas, including: 

• Productivity programs • Latest source code 

• Programming tools • Graphics Games 

• Commercial demos 

Newsgroup archives (comp.sys.be) Developer mailing list (Be DevTalk) 
BeSpecific 3 is brimming with useful BeOS Preview Release- 
compatible software. A “must have" companion for all users of the 
BeOS. 

(SBESPEC) Our Price $39 



Pilot Attache Disk 1 

(First in a regular series) 

by Adamation 

The Pilot Attach^ CDROM, designed for the 
popular US Robotics Palm Pilot organizer 
provides you the best in Pilot shareware. 

Extend your Pilot’s capabilities across a 
wide range of application areas, including: 

• Personal productivity tools • Newsgroup information 

• Programming tools • Games 

• Utilities 

Fully tested, Pilot Attache’s shareware treasure throve will help you 
get the most out of your Palm Pilot. When you travel with your Pilot, 
don’t forget your Attache. Pilot Attache...your passport to success. 
(SPATCHE) Our Price $29 
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Check out our Web site! 

' Full proifuct descriptions • Hundreds of more products 

littp://www.iievilepot.com 


SoftPolish CD-ROM 

B_ Software 

• The essential too! for software 
quality assurance on the Macintosh 

• Helps you identify inconsistencies 
with Apple's user interlace guidelines, 
misspelled words, missing resources, 
and other mistakes 

Provides tools to put the finishing touches on software distribution 
packages prior to release 

Works independently of any programming language or environment 
Idea! for sanity checking software throughout the development 
process 

(SSOFTPOL) Our price $99 




Future BASIC II 

by Staz Software 

FutureB/SiC II is the award winning 
leader in Macintosh BASIC 
programming. 

• Source level debugger and Interactive compiler/editor 

• Muiti-file Project manager and Multi-file find and replace 

• Super fast compilation, 32 bit clean, and System 7.x savvy 

• QuickBASIC converter 

• Getting Started manual with over 500 example files 

• Full support of standard BASIC 
(SFBASIC2) Our Price $229 
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StoneTable 68K/PPC 

by StoneTablet Publishing 

StoneTable is a powerful and professional replacement for the List 
Manager used by developers worldwide. Version 3.0 is a new 
release with many improvements inciuding better clipboard and 
drag/drop integration with other applications. 

• Available for use with CodeWarrior C & Pascal 

• Includes libraries for 68K (A4 & A5) and PowerPC 

• An LTable-iike class is provided to incorporate StoneTable into the 
PowerPlant environment 

(SSTONEFAT) Our Price $199 


Memory Mine 

by Adianta, Inc. 

• Monitor heaps, identify 
problems such as memory 
leaks, and stress test 
applications 

• Active status of memory in a 
heap is sampled on the fly: 
allocation in non-relocatable 
(Ptr), relocatable (Handle) and 

free space is shown, as are heap corruption, fragmentation, and more 
> Allxate, Purge. Compact, and Zap memory lets users stress test 
all or part of a program 
(SMEMMINE) Our Price $99 
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Spotlight 

by Onyx Technology, Inc. 

Spotlight is a stand alone debugging aid 
that performs memory protection (arrays, 
heap accesses, outside your heap, low 
mem, etc), discipline checking on toolbox 
calls, and leaks detection. 

• Spotlight is sold on an annual 
subscription basis 

• The subscription service provides all 
updates 

• Includes maintenance releases for one 
year after 

the initial purchase or renewal date. 
(SSPTLT) 0urPrice$199 



VOODOO 1.8 

by UNI SOFTWARE PLUS 

• Stand-alone version control tool for all 
sorts of projects (software 
development, documentation, design. 
CAD, publishing, etc,) 

• Smooth integration with Metrowerks 
CodeWarrior and BBEdit. 

• Simple and clear management of variants 
and revisions of entire projects (not only 
of single files) 

• Easy-to-use graphical project browser gives 
access to all versions that were ever stored. 


• Recording of the complete history (who 
made which changes when and why) 

• View differences between versions (not 
only for text files!) 

• Efficient delta storage of arbitrary files 
(text as well as non-text 

files) gains savings of 95 % and more 

• Administration of users with hierarchical 
access rights 

• Configurable local file locking (Finder flag 
or 'ckid' resource) 

• Scriptabie, essential parts PowerPC native 

Single license (SV00D001) $229 

2 pack (SV00D002) $359 

5 pack (SV00D005) $799 

10 pack (SV00D0010) $1369 

20 pack (SV00D0020) $2399 

Additional pricing available on request. 

SEE RELATED CATEGORY: Dev. Environments 
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NetMinder Ethernet 

by Neon Software 

NetMinder Ethernet is a software-only 
protxol analyzer which captures and 
decodes a full range of Ethernet protocols 
including IP, AppleTalk, NetWare. NetBIOS 
and DECnet. Features include: 

• Sophisticated long-term monitoring with HTML output 

• Intuitive and powerful filtering capabilities 

• Automatic mapping of names to Ethernet, AppleTalk, and IP 
Addresses 

• Rules-based engine for detecting unusual network conditions 

• Customizable graphs for bandwidth utilization and packet rates 
(SNETMD) OurPnce $715 



Apprentice 7 

by Celestin Company 

Apprentice 7 is a high-quality CD-ROM collection of over 600 
megabytes of up-to-date source code, utilities, and info for Mac 
programmers. All of the source code and utilities are completely 
new or updated for this release. 

• Frontier 4.1, the highly-acclaimed scripting environment 

• More PowerPlant AND many more PowerPC samples 

• Coot new languages and environments added (Clean, Eiffel, F, 
Tci-Tk) 

• Hot new demos from leading Mac development companies 
(SAPPRENT) Our Price $35 
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Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 


PRODUCT CODE 

AG Author SAGA 

Be Basics SBEBASIC 

Bee-one SBEEONE 

C-tree Plus® Database Handler SCTPDH 

Complleit! SCOMPn 

CPU Doubler SCPU2X 

DeslgnWorks4.0 SDWORKS 

dtp SDTF 

EtherPeek SEPEEK 

Fortran 77 SDK SF77 

ICONIX PowerTools^e Pack SICPP6 

ICONIX PowerTools-8 Pack SICPP8 

ICONIX PowerTools-10 Pack SICPPl 0 

ICONIX PowerTools-AdaFlow SICADA 

ICONIX PowerTools-ASGlI Bridge SICASCII 

ICONIX PowerTools-CoCoPro SICCOCO 

ICONIX PowerTools-DataModeler SICDATAMOD 

ICONIX PowerTools-FaslTask SICFASTTASK 

ICONIX PowerTools-FreeRow SICFREEFL 

ICONIX PowerToois-Object Modeler SICOBJMOD 

ICONIX PowerTools-PowerPDL SICPOWER 

ICONIX PowerTools-QuIckChart SfCQUICKCH 

ICONIX PowerTools-SmartChart SICSMART 

ICONIX Training & Consulting TICOMX 

IMSL Math and Stat Library SIMSLSTAT 

Info-Mac X SINFOMAC10 

Ionizer Real-Time Spectral Reshaping Tool SIONIZER 

LiveAccess™ 1 User Edition SLAUE 

LiveAccess™ 1 Developer Edition SLADE 

LiveCard SLCARD 

U Profiler SUPROF 

MacA&D 6.0 SMACADP 

MacFlow Flowchart Design and Development SMACFLO 

Mac Source II SMACSOURCE 

NIsus Writer 5.0 SNISUSW 

Plan St Track™ : Project Planning and Management SPLNTRK 

Phyla™: ObjecFOriented Database SPHYLA 

QUED/M 3.0 SQUEDM 

r-tree Report Generator SRTRG 

Spellswell Plus 2.1 SSPELL 

Step-Up Installer Pack SINSTALL 

SuperAnalyst SSANAL 

SuperPlot SSPLOT 

SuperPlotPRO SSPLOTPRO 

Visual Caf^ SVCAFEMAC 

VText SVTEXr 


OUR PRICE 

$99.00 

$69.00 

$139.00 

$695.00 

$149.00 

$79.00 

$995.00 

$695.00 

$745.00 

$699.00 

$5,945.00 

$6,945.00 

$7,845.00 

$1,395.00 

$1,395.00 

$1,395.00 

$1,395.00 

$1,395.00 

$1,395.00 

$1,395.00 

$1,395.00 

$1,395.00 

$1,395.00 

$2,945.00 

$495.00 

$39.00 

$800.00 

$69.00 

$99.00 

$149.00 

$295.00 

$1,995.00 

$179.00 

$29.95 

$220.00 

$179.00 

$179.00 

$89.00 

$445.00 

$49.00 

$219.00 

$99.00 

$195.00 

$295.00 

$199.00 

$349.00 
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Lasso 2.5 iniciiiiiiiii 

By BlueworltJ **** 

Communications 


Lasso 2.5 is tie ultimate 
FileMaker Pro Web development 
tool for creating online stores, 
discussion groups and other 
robust web appiications that can 
; handle hundreds of thousands of 

i hits per day. Over 50 new tags inciuding math, string and 
; variable aiiow unparraiieied data handling capability, Create 
embedded operations with the inline command, Lasso Server 
edition supports multihoming and offers superior performance. 

Order Lasso today the award-winning toot that which sets the 
standard for Mac OS dynamic Web database publishing. 
•Multi-threaded performance 

• Supports CDML and LDML 

• Enhanced security for eiectronic commerce 
Lasso 2.5 CGI/Ptug-ln (SLASPG) $499 
Lasso 2.5 Server (SLASSVR) $649 


j 

i 


I 



BBEdit 4.5 

by Bare Bones Software 

(SBBEDIT) 0urPrice$119 

Also see Tools, Libraries and 
Utilities, page 0 



WebTen 

by Tenon Intersystems 

WebTen is an industrial- 
strength, high- 
performance Apache Web 
server for Power Macs. 

WebTen's Web-based 
browser interface enables 
local or remote 

administration via your favorite browser. Since Apple's NeXT 
acquistion, Tenon has extended their unique “UNfX virtual machine” 
technology to produce a set of ''Rhapsody-Ready" internet 
applications. WebTen is the first offering in this series. 

• WebTen is the fastest Web server on Power Macintosh 

• Sustains up to 10,000 connections a minute, or over 10 million 
connections a day 

• Apache runs in Tenon’s multi-threaded, pre-emptive 
multitasking environment 

• Tenon's unique technology supports the widely acclaimed 
Apache Web server as a double-clickable Macintosh application 
(SWEBTEN) Our Price $495 




duct! 

CyberStudio 

by GoLive Systems 

GoLive CyberStudio is the complete 
solution for HTML layout, design 
and Web site management. It gives 
Macintosh users unprecedented 
creative control and flexibility when 
designing a Web site. GoLive 
CyberStudio lets graphic designers and publishers visually 
design and manage a professional-quality Web site—including 
the latest multimedia features—without performing any HTML 
programming. Yet, GoLive CyberStudio also includes HTML 
source-code and JavaScript tools, which help Web designers 
and programmers integrate interactivity into a site. Because 
GoLive CyberStudio is the first Web site design software to 
always work in a native HTML file format, it allows graphic 
designers and Web programmers to work well together. 
(SCYBERS) Our Price $349 



ObjectSet Mail SDK 

by Smartcode Software 

• Powerful C-n- classes for integrating 
Internet e-mail in your applications 

• Helps you write software that can share 
mail with other leading e-mall products 

• Royalty-free MIME, SMTP, and POPS APIs 
for Macintosh, Windows, and Unix 


• Gives you the most robust MIME parser and encoder available 

• ideal for use in Internet and Intranet environments 

• Comes complete with samples with documented, reusable 
source code 

• Free standard technical support 
(SOSMSDK) Our Price $495 


pn« mtimw igiiTitnig^ 



HyperGuide 1.0 

by Lakewood Software 

HyperGuide 1,0 is a 
hybrid multimedia 
authoring tool and on¬ 
line documentation 
system for the 
Macintosh and World 
Wide Web. HyperGuide 
provides integrated 
searching, indexing and 
bookmarking features. 

Supported media elements include: rectangle and scrolling fields, 
lines and shape fills, most QuickTime-supported image formats, 
anti-aliased text and QuickTime VR movies. HyperGuide also 
includes an integrated screen capture utility and user-configurable 
slide show mode. 

(SHYPGUD) 0urPrice$149 
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PageCharmer: Sizzling Effects... 



PageCharmer 1.0 

by Mainstay 

PageCharmer is a set of customizable interactive appiets that 
enhance web pages without writing a single line of HTML code, 
Whether the web site is aiready up and running or designing one 
from scratch, PageCharmer gives you the power to make it stand 
out from the crowd with sophisticated appiets ttiat can be 
personaiized to fit most any need. 

FEATURES: 

LiveG-Map, LiveT-Map, LiveG-Button, LiveT-Button, LiveGT-Button, 
LiveG-Ticker, LiveT-Ticker, LiveG-Marquee, and UveT-Marquee. 
(SPGCHRM) Our Price $99 


Rumpus 

by Maxum Development 

Maxum’s new, high- 
performance FTP server tor 
the MacOS. Based on 
Maxum's RushHourTCP/iP impiementation, Rumpus 1.0,1 offers 
the performance and reiiabillty of high-end workstations with the 
ease of use, security, and flexibiiity of the Macintosh, 

• Simpiified setup, with no need to configure AppleShare, Fiie 
Sharing, or Users & Groups for stmpie anonymous FTP 

• Anonymous and/or secure server access, with separate 
security settings for anonymous vs. secure users 

• Automatic MacBinary and Binhex encoding 

• Compiete logging, with separate anonymous and secure 
access iogs, inciuding anonymous user passwords 

• Up to 32 simultaneous connections 
(SRUMP) 0ur Price$195 
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Power MachTen 4.0.3 

by Tenon Intersystems 

MachTen is the oniy Macintosh product that can turn your 

Macintosh into a compiete Unix workstation. Based on 

BS04,4 and the Mach kernei, MachTen brings the power 

of Unix to your desktop at an extremeiy attractive price point. 

MachTen enables you to: 

• Run a high speed internet server, complete with WWW, FI?, NFS, 
DNS and print service 

• Build a Mutihomed Web Server 

• Develop applications in a Unix development environment, replete 
with the acclaimed GNU development toolset 

• Program in Ada, C, C-i-h, Pascal, Fortran, and more 

• Run Xwindows applications, from remote workstations or on 
your Macintosh 

• Run hundreds of Unix applications, already ported for MachTen 
and available on our Ported Applications CD-ROM 

• Run Softwa'e.com Inc's acclaimed Post-Office mail transport service 
(SM10PPC) Our Price $695 


CGI Toolkit 

by Pictorius, Inc. 

The Pictorius CGI Toolkit is the fast and 
easy route to high performance CGIs and 
ACGIs for your Mac Web site. 

• Interactively develop CGIs while the 
web server, the CGI Toolkit and the browser are running on the 
same machine 

• Interactively develop, test and debug CGIs before compiling 

• Powerful debugger allows you to edit code, roll back, code and 
change input values white your application is running 

• Fully object oriented so you can re-use your code 

• Automatic handling of Apple Events so you can concentrate on 
building functionality 

• Easy creation of multi-function CGIs which reduces application 
footprint and RAM usage 

{SCGITLKT) Our Price $149 



I 




Here are more products. For full product descriptions piease see our Web 
site, or feel free to call, fax, or E-mail us. 


PRODUCT 

OOFILE Reporter Writer 
ScriptDemon 
WedAlias 1.0 
WebSiphon 


CODE 

SOORW 

SSDEMON 

SWEBALS 

SWSIPHON 


OUR PRICE 

3499.00 

$949.00 

$129.00 

$495.00 


Web site: http://www.devdepot.conn • E-mail: orders@devdepot.com 
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Scripting AddftJon' 

Thii iUljernEt 


TCP/IP Scripting Addition 

by Mango Tree Software 

• Award-winning AppleScript scripting 
addition 

• Allows you to write scripts using 
MacTCP’^^ commands in AppleScripf^^ 

• Send e-mail or files ttirough a script, 
check if users are logged on (via Finger), automate FTP, Gopher, 
NetNews, Telnet, and LPR, verify links in HTML documents, and 
quickly write many other TCP/IP client-server programs 

• Works with AppleScript, MacTCP 2.0.4 and Open Transport 
(STCP) Our Price $49 



Scripter 2.0 

by Main Event Software 

For professionals, for novices, for 
webmasters, for solutions providers, 
there’s only one serious choice. Scripter! 

• Scripter and FaceSpan work together: 
one click opens your FaceSpan script in 
Scripter, another sends it back 

• Debug handlers without modifying your scripts using the Call 
Box 

• Applet simulation, live editing. Object map, associated 
terminology 

• Search backwards, block generators, more navigation 
shortcuts, more drad-and-drop, and an even more enhanced 
trace log 

• Mow Includes ScriptBase; stores your data and media elements 
and share them between scripts all with a special new browser 

• Easily write and compile scripts that have handler declarations 
and other vocabulary specific to a particular scriptable 
application 

• Scripter is the natural companion to AppleScript for users at all 
levels of proficiency. Don’t write scripts without it! 

(SSCRIPTER) Our Price $199 


DynaMorph 

by Morph 



DynaMorph is the only cross-platform, server-side scrlpflng language. 
Easily build and maintain dynamic websites and web-based 
applications. Access external databases, separate the format of a 
website from its content, conduct e-commerce transactions and 
more, DynaMorph makes sites and applications completely portable. 
(SDYNA) Our Price $399 




FaceSpan v3.0 

by Digital Technology 
International 

FaceSpffii Is a cutting edge interface 
design and rapid application 
development (RAD) too! which gives 
you the power to build and customize Macintosh applications quickly 
and easily. 

• Acts as your front end for AppleScript or any other OSA (Open 
Scripting Architecture) language. 

• Allows you to automate often-repeated tasks, customize and 
integrate existing applications, build new applications and 
personalize your computing environment. 

• NEWI Allows you to create interlaces and applications that 
conform to the Mac OS 8 look and feel. 

• MEWl Supported display objects now include tab panels, 
disclosure triangles, bevel buttons and more. 

• NEW! FaceSpan run-time now launches up to 5X faster. 

• Includes an unlimited, royalty-free distribution license for the 
Interfaces and applications you create, 

(SFACESPAN) Our Price $149 


Script Debugger 

by Late Night Software Ltd. 

• A powerful and flexible AppleScript 
authoring tool - get the most from 
AppleScript! 

• Advanced debugging environment offers 
single-step script execution with 
breakpoints 

• Script Debugger dictionary browser 
features a graphical view of objects 
provided by scriptable applications 

• Includes Late Night Software Scripting Additions - a collection of 
more than 70 new AppleScript commands, and Scheduler, a utility 
that allows you to launch scripts at pre-determined times 
(SDEBUG) Our Price $129 

WindowScript 

by Royal Software, Inc. 

WindowScript is the ultimate tool for designing Macintosh user 
interfaces using HyperCard. Design Real "Macintosh" user- 
interfaces right inside HyperCard. Until now you either created 
HyperCard stacks or Macintosh applications. With WindowScript you 
can literally bring the look and feel of a real Macintosh user- 
interface to HyperCard. If you're a HyperCard developer, interface 
designer, application developer, program manager or tester 
searching for a prototyping tool, WindowScript is perfect for the job, 
(SWSCRIPT) Our Price $149 



WAiT— 
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Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 

PRODUCT CODE OUR PRICE 

PreFab Player SPLAYER $95.00 
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CyberStudio 

by GoLfve Systems 

GoLive CyberStudio is the complete 
solution for HTML layout, design 
and Web site management, It gives 
Macintosh users unprecedented 
creative control and flexibility when 
designing a Web site. GoLive 
CyberStudio lets graphic designers and publishers visually 
design and manage a professional-quaiity Web site—including 
the latest multimedia features—without performing any HTML 
programming. Yet, GoLive CyberStudio also includes HTML 
I source-code and JavaScript tools, which help Web designers 
and programmers integrate Interactivity into a site. Because 
j GoLive CyberStudio is the first Web site design software to 
I always work in a native HTML file format, it allows graphic 
i designers and Web programmers to work well together, 

I (SCYBERS) Our Price $349 


NewtCard 

by NS BASIC Corporation 

NewtCard lets you put text, 
drawings, pictures and sound 
into a stack of smart cards on 
your Newton, Add buttons to 
navigate, fields to collect data, 
and scripts to bring your project 
alive with the tap of a pen! 

• Create business solutions, 
education courseware, inter¬ 
active presentations and more 
in an easy to use environment. 

• Enter text, numbers dates and times easily. 

• Create your own drawings or copy drawings and text from 
NewtWorks 

• Navigate to other cards, stacks or applications by clicking 
buttons you create, 

• Add scripts to your stacks in easy to use BASIC! 

(SNEWT) Our Price $99 


by Roundabout Logic 

Nodester is Roundabout’s 
renowned rapid panoramic 

editor for QuickTime VR. Nodester generates interactive QTVR 
panoramic movies which look out from a center or nodal point, 
allowing the viewer to experience the effect of a full 360 degree 
panorama. 

• Hot spot editor 

• Built- in image editor 


• Photoshop Acquire Module that supports ai! devices including 
film cameras, (through scanners or photo CDs), digital cameras, 
video cameras and digital video cameras. 

• Small memory footprint 

• Clean user-friendly interface 

• Plug-in architecture 

• Export both QuickTime VR 1.0 and 2,0 

System Requirements: Runs on Power PC only; requires 
allocation of 8 mb real RAM, 

(SNODE) 0urPrice$169 


Widgetizer 

By Roundabout Logic 

Widgetizer is Roundabout’s 
peerless rapid object editor for 
QuickTime VR. Widgetizer generates interactive QTVR object 
movies which look in at a center point or plane, simulating the 
effect of holding an object in the hand and turning it around to see 
all sides, top and bottom. 

• Definable hot spots 

• Custom backgrounds 

• Frame-based animation 

• Sound integration 

• Small memory footprint 

• Clean user-friendly interface 

• Plug-in architecture 

• Exports both QuickTime VR 1.0 and 2,0 

• Photoshop Acquire Module that supports all devices including 
film cameras, (through scanners or photo CDs), digital cameras, 
video cameras and digital video cameras. 

• Supports device (mechanism) software controlled QTVR object rigs 

• Expensive software controlled mechanisms are not required. 
System Requirements: Runs on 68K or Power PC; requires 
allocation of 8 mb real RAM. 

(SWIDG) Our Price $169 


ExposurePro 

by The Beale Street Group, Inc. 


ExposurePro allows you to, at the touch 
of a key (user-defined, of course), 
freeze the screen, select a portion with 
the powerful selection tools, and save 
the image to a TIFF, GIF, PNG, JPEG, 
PICT, or PICT clipping file. You can also 
save to the Clipboard, Scrapbook, or 
even send it directly to your printer, 

The power of ExposurePro lies not only in 
its screen capture capablities, but also in the vast array of editing tools: 
painting tools, drawing tools, all with customizable features rivaling a 
full-blown image editing program. Convert to a different bit depth. 
Dither, The text tool might make you trash Illustrator! 

(SEPRO) Qur Price $119 


[ 
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Digital Imaging Technology 

QuicKTime VR Authoring Studio is Now Avaiiable for oniy $299 
when you purchase seiected Kaidan products. 


QuickTime VR 


Get the QTVRAS for only $299 when you purchase the KlWi+. QuickPan Magnum or Magellan QC. This is a savings of approximately $95 off 
the standard retail price. Sorry, upgrades from the original VR Suite are not available. 

(HQTKB) Our Price $299 

Available only with Kaidan products KiWi+. QuickPan Magnum and Magellan QC. 





Mageilan QC 

by Kaidan 


The Magellan QC is capable of handling 

r objects as large as six inches in diameter 

and five pounds in weight, the Magellan 
|H| QC is the perfect choice for tiiose 

needing to capture small objects at a 
reasonable price. Real-world objects can 
be turned into 3-D virtual reality movies 
using the QuickTime VR Authoring 
Studio and the Magellan QC. 

The Magellan QC leverages the 
capabilities of the Connectix " Color 
QuickCam" digital camera for QTVR 
object capture. The Color QuickCam’s close 
focusing capability (one inch to infinity). 640 x 480 resolution, serial 
interface (no video card required). 24-bit color support, convenient 
size and low cost make it an ideal camera for many simple QTVR 
object movies. Using the Magellan QC is easy. Simply locate the 
object on top of the adjustable pedestal, perhaps with a small piece 
of double-sticky tape, and then adjust the arms and pedestal so 
that the center of the object is centered in line with the camera and 
the rotation axis of the swingarm. 

(HMAGQC) Our Price $299 



QuickPan Magnum 

by Kaidan 


tOlSOC't 



The QuickPan Magnum Series 
consists of two models, the QPX- 
1 and QPX-2. Featured on both 
models is the new QPU-2 camera 
bracket. Based on the highly 
successful KiWi, it provides a 
sturdy, collapsible system for 
the mounting and adjusting of 
a wide variety of cameras and 
camcorders. The new base designs 
used on the Magnums are a refinement 
of our earlier bases, with the QPX-1 having a fixed base and the 
QPX-2 having a new low-profile micro-tilt adjustment stage. The 
easily adjustable click-stops will let you capture a panorama in a 
few seconds. The QPU-2 has two accessories, a Landscape 
Bracket for positioning the camera in the landscape orientation 
(QPLB-1) and a Countenweighting Kit (QPCW-1) used to balance 
large cameras or camcorders, such as the Sony VX-1000, that 
have a center of mass well behind the pivot axis. 

QuickPan Magnum-1 (HQPMAG1) Our Price $499 
QuickPan Magnum-2 (HQPMAG2) Our Price $549 


QuickPan Magnum Accessories 


Counteiweighting Kit 


Mageilan Accessories 


Magelian QC Pedestal Set 

Two extra pedestal tube assemblies, one 2,5“ and another 6“ 
long. These extra pedestal tubes are used to support objects of 
varying sizes on the Magellan QC. 

(HMAGPEO) Our Price $39 

Mageilan QC Detent Wheels 

A pair of optional detent wheels (Color = Gold) with 8 (45 
deg), 12 (30 deg), 14 (25.7 deg), 16 (22.5 deg) and 18 (20 
deg) settings. The standard wheels (Color = Aqua) provide 10. 
15. 20.24 and 36 positions. 

(HMDWHLS) Our Price $74 


The Counterweighting Kit includes a weight and adjustable arm 
that is used to offset the weight of targe, heavy cameras and 
camcorders. 

(HWHTK7) Our Price $129 

Detent Wheel 

Detent Wheel (5-inch) (Color = Purple): 10,14,18,24 and 30 
Position (QPDD-2) 

(HQDWHLS) Our Price $49 

QuickHlt Leveler 

A leveling stage, similar to the one found on our QuickPan 
Magnum QPX-2. that mounts between your panhead or camera 
and your tripod. It makes the leveling process quick and easy. 
Particularly useful when you plan to shoot a number of 
QTVR/VR nodes in a short period of time. 

(HQTLVLR) Our Price $149 
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KiWi 

by Kaidan 

The KiWi™ 
is the most 
affordable VR/QTVR 
panhead, bringing digital 
photographic panoramas 
to an even wider audience. 

It’s the perfect companion to 

programs such as QuickTime VR Authoring Studio, PhotoVista and 
Nodester, providing a complete solution for anyone interested in 
adding VR panos to their websites and multimedia appiications. 

The KiWi^'^ consists of two intersecting black anodized aluminum 
struts that adjust and lock to accommodate a wide range of 
cameras, such as the Apple QuickTake 100/150/200, Kodak 
DC50/120, APS film cameras and 35mm SLRs equipped with wide- 
angle lenses. KiWi™ attaches to any standard tripod and camera 
equipped with a standard 1/4-20 mounting thread. 

(HKIWI) Our Price $99 




KiWi+ 

by Kaidan 


The KiWi+ adds a compact, yet 
durable click-stop mechanism and the 
same twin-axis bubble level found on the top-of-the-line QuickPan 
Magnum Series heads. The twin-axis bubble level (recommended 
by Apple and VR professionals) provides a clear indication of level, 
even when the unit is slightly above eye level. The click-stop 
mechanism uses easily replaceable detent discs, which are 
available in a number of positions (8,12,16,18,20). The KiWI+ 
ships with one disc of your choice and extra discs are available 
separately or as a set. The click-stops speed the process of 
shooting a panorama by eliminating the need for the photographer 
to look at the unit in order to visually align the Index increment. 


KiWi -I- Ships with detent disc of your choice 


KiWi-i- with detent disc size 8 
KiWi-i- with detent disc size 12 
KiWi-i- with detent disc size 16 
KiWi-i- with detent disc size 18 
KiWi-t- with detent disc size 20 


(KIWIP8) Our Price $249 
(KIWIP12) Our Price $249 
(KIWIP16) 0urPrice$249 
(KIWIP18) 0urPrice$249 
(KIWIP20) Our Price $249 


KiWi and KiWi+ Accessories 


QuickTilt Leveler 

A leveling stage, similar to the one found on our QuickPan 
Magnum QPX-2. that mounts between your KiWi or KiWi-i- and 
your tripod. It makes the leveling process quick and easy. 
Particularly useful when you plan to shoot a number of QTVR/VR 
nodes in a short period of time. 

(HQTLVLR) Our Price $149 

KiWi-to-KiWi+ Upgrade 

Includes the necessary parts required to turn your KiWi into a 
KiWi+ — adding click-stops and the twin-axis bubble level. Comes 
with a detent disc of your choice (8,12,16,18 or 20 positions}. 

(HKIWIUP) 0urPrice$199 

KiWi+ Detent Discs 

KiWi-r Detent Discs are available singly or in a set of four, in both 
cases you get to choose whichever discs you need. 

(HDTDISC) Our Price $24.95 each 

(HDTDISC4) Our Price $89 set of four 

Choices include: 8,12,16,18, or 20 position detent disc 


Landscape Bracket 

The Landscape Bracket is a right angle bracket that allows you to 
mount the KiWl or KiWi-n upright camera bracket in a horizontal 
orientation. This bracket is primarily used for cameras that have a 
limited field of view and you need to limit the number of shots. 
(HLDBRAQ Our Price $42 

Flash Hotshoe Level 

A dual-axis bubble level that slides into your camera’s hotshoe. It’s a 
useful tool to help level the camera on the upright camera bracket. 
(HFLASH) Our Price $39 

Offset Spacer 

The Offset Spacer Is a circular spacer that may be required for 
very narrow cameras (i.e. certain Ricoh digital cameras) in order 
to position the center of the lens over the pivot axis. 

(HOFFSPAC) Our Price $24.95 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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Media Cleaner Pro 

by Terran Interactive 

Use Media Cleaner Pro 2.0 to optimize and compress video for 
CD-ROM, kiosk, or the Internet, Media Cleaner Pro automates 
your work fiow allowing you to get the highest quality video, 
faster and easier than any other program on the market, 

• includes Adobe Premiere Export module 

• Optimal paiette generation, Drag-and-drop batch processing 

• RealMedia, VDOLive and improved QuickTime support 

• Dynamic Preview Window, the Media Wizard, multiprocessor 
support and more! 

System Requirements: 

68040 Mac or better (PowerPC strongly recommended, req'd for 
RealMedia), QuickTime 2.0 or later (2.5 strongly recommended) 

8 Mb application RAM, MacOS 7.0,1 (7,5 or later recommended) 
SoundManager 3.2, CD-ROM Drive 
(SMCP) Our Price $359 


Order Toll-free 
800-MACDiV-1 


i8(JWi22-338l) 


Music Itracks 

by BeachWare, Inc. 

A new PC/Mac & Audio multimedia music 
CD-ROM. The clips include musical 
introductions, fanfares, background music, 
and more. This collection offers you 100 
music clips stored in .WAV format for 
Windows, SoundEdit & AIFF formats for Macintosh and as Audio 
tracks for audio CS players. All of the music clips are completely 
license and royalty-freel! Mac System requirements: Mac Plus or 
greater, CD-ROM drive. PC system requirements: Windows 3.1 or 
later, Sound Blaster compatible board, CD-ROM drive. 

(SMT) Our Price $24.95 



MultiWare 




Multimedia Collection 

by BeachWare, Inc. 

Introducing a new Audio multimedia music 
CD-ROM for the Macintosh, This disc is a 
collection of clips ideal for Desktop 
Presentations and other Multimedia 
applications. This Incredible collection of license-free media clips is 
bursting with 240-1- color pictures and backdrops (PICT), 200-r- sound & 
music clips (SoundEdit), 140-i- QuickTime movies, and a variety of 
multimedia tools for use with the Macintosh. 

(SMWMC) Our Price $24.95 


^ webAllas 1.0 

j by Lakewood Software 

webAlias 1.0 is an 
integrated image map 
editor and anti-aliasing 
text tool for web and 
graphic designers. Use 
webAlias to create 
complete web sites, 
single web pages, and graphic content for multimedia and web 
design projects. webAlias integrates support for line, shape, free 
form, field and button objects, webAlias' anti-aliasing features 
include support for embedded pictures and gradients in text, as well 
as multiple shadow and highlight effects. 

(SWEBALS) Our Price $129 


HyperGuide 1.0 

by Lakewood Software 

HyperGuide 1.0 is a hybrid 
multimedia authoring tool and on¬ 
line documentation system for the 
Macintosh and World Wide Web, 

HyperGuide provides integrated 
searching, indexing and 
bookmarking features. Supported 
media elements include: rectangle 
and scrolling fields, lines and shape fills, most QuickTime-supported 
image formats, anti-aliased text and QuickTime VR movies, 
HyperGuide also includes an integrated screen capture utility and 
user-configurable slide show mode, 

(SHYPGUD) Our Price $149 
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Here are more products. For full product descriptions please see our Web 


site, or feel free to call, fax, or E- 

•mail us. 


PRODUCT 

CODE 

OUR PRICE 

AudioTrack 

SAUDIOTRK 

$270.00 

Be Studio 

SBESTUD 

$99.00 

Captivate 4.6: Essential Graphics Utilities 

SCAPTIV 

$79.00 

Clip VR 

SCLIPVR 

$89.00 

Media Cleaner Pro 

SMCPUP 

$359.00 

Screen Machine 

SSM 

$24.95 
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PowerSD 

by Techworks 

The power of an arcade on your 
PowerPC Based on award winning 
3Dfx VooDoo Graphics. The PowerSD 
works with your existing graphics 
card and multi-sync monitor to provide you the absolute in 3D 
performance. Install tie PowerSD in your PowerPC (requires one 
available PCI slot in your system) and use the provided pass-through 
cable to turn your PowerPC into a Power Arcade system! 

PowerSD comes bundled with these awesome 3D enabled games: 

• Quake'®: Episode 1 (8 level) by Id Software 

• MechWarrior® 2 by Activision 

• VR Soccer’" by VR Sports (Actua™ tor Europe) 

• Weekend Warrior™ by Bungle 
(SPWR3D) Our Price $249 


Abuse 

by Bungle Software 

Abuse is 360 degrees of side-scrolling action. 

Run, jump, fall and fly in any direction - through 
industrial corridors, caverns and sewers. Destroy 
enemies in any direction with grenade launchers, 
rocket launchers, napalm and nova spheres! Avoid 
deadly traps with jet packs and turbo boost! 

Key Features: 

• Point and Kill Interface. Move and annihilate mutants in complete 360° freedom 

• Blast your way through floors, walls and ceilings in search of the ultimate 
power-up! 

• Abuse is 360 degrees of side-scrolling action. Run, jump, fall and fly in 
any direction - through industrial corridors, caverns and sewers 
(SABUSE) Our Price $51 




1000 Games for 
Macintosh 

by BeachWare, Inc. 

The best Macintosh game disc in the 
entire world, this CD-ROM contains over 
one thousand great shareware and public domain programs. Battle ugly 
aliens, blast apart run-away asteroids, deal yourself that royal flush or 
solve that 3-D puzzle, this disc has it all! System requirements: Mac 
Plus or greater, CD-BOM drive, and 2 MB of available RAM [4 MB of 
RAM when running under System 7). 

(STGM) Our Price $24 







Myth The Fallen Lords 

by Bungie Software 

PC GAMES MAGAZINE’S, Most Anticipated 
New Game Award 

I The Fallen Lords is a fully 3D real-time strategy 
game of epic battle. A multimetric game. Myth: 
The Fallen Lords gives gamers unprecedented 
I freedom to view their forces, orbiting around 
the heads of a formation or zooming in for a 
close-up on savage melee, Myth: The Fallen Lords includes maps 
designed for networking, and alternate networking scenarios like 
Assassin and King of the Hill, 

(SMYTH) Our Price $49 


Classic Arcade 

by BeachWare, Inc. 

Ten of your favorite coin-arcade games, redone 
with killer graphics and sounds! Walk through a 
virtual arcade and test your game playing sWIIs 
with these exciting arcade cicssics. Ten games, 
including Moon Lander, Astro-Boing, Hyper 
Hockey, Ballistic Avenger, and more. System Requirements: Mac — Color 
Mac with 8 MB RAM, CD-ROM drive. PC 486 wiBi 8 MB RAM, Sound 
card, SuperVGA, CD-ROM drive, 

(SCLV\) Our Price $24 



Marathon Ih'ilogy Box Set 

by Bungle Software 

The Marathon Trilogy Box Set brings all three 
Marathon games together in one affordable package, 
with tons of extras thrown in, Besides Marathon, 
Marathon 2: Durandal and Marathon infinity, you'll also 
receive a staggering 1200 maps, featuring never- 
released Bungie maps and the winners of the Infinity 
Mapmaking Contest, The Marathon Scrapbook (a behind-the-scenes look at 
themaking of the Maratfion games). Marathon collectables like the Marathon 
3-sticker set, and to top it off, the award-winning game that laid the 
groundwork for MaraUion: Bungle's breakthrough Pathways Into Darkness. 
The Marathon Trilogy Box Set is native to the Power Macintosh, utilizes the 
graphics acceleration of 630 and 6200 machines, is 8,16 and 24-bit color 
capable, and can be played with joysticks and game pads. The package 
requires a 68040 or higher Macintosh, CD-ROM dnve, 8-bit color monitor 
(13" recommended), and System 7 or later, 

(SMTBS) Our Price $65 



WAiT— 

Here are more products. For full product descriptions please see our 

i TI 

here'* 

site, or feel free to call, fax, or E-mail us. 



PRODUCT 

CODE 

OUR PRICE 



A Zillion Sounds 

SAZS 

$24.00 



Casino! 

SCAS 

$24.00 



Night Sky Interactive 

SNSI 

$24.00 



Trivia Warehouse 2000 

STW2K 

$24.00 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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Advanced Fitemaker Pro 
4.0 Developer Guide 

By Chris Moyer 

A useful and straightforward manual for 
FileMaker Pro 4.0, this book is loaded 
with valuable tips tor high-end 
deveiopers, especially those who are 
developing databases as a back-end to 
applications. 

(BFILEP) Our Price $39 



Languages: 
utomating the Web 

D. Dougherty, P. Lomax, G. van 
Possum, & N. Heinie 

This book guides users and developers 
in choosing and deploying scripting 
solutions. Users can add scriptable and 
extensible behavior to the Web in a 
variety of ways. The book offers an 
array of articles in Web client user 
interface, Web server programming interface, the World Wide Web 
gateways, and Web database connectivity. 

(BSPWWW) Our Price $26 


The QuickTime VR Book 

by Susan Kitchens 

The concise infonnation in The 
QuickTime VR Book shows you how to 
add QuickTime VR content to your Web 
site or CD-ROM, it covers the basics of 
virtual-reality technology and such topics 
as planning your movie, viewing, and 
creating panoramas and object movies, 
understanding and setting up hot spots, 
and linking large projects together. An indispensable resource tor Web 
and multimedia producers, photographers, and 30 artists. 

(BQTVR) Our Price $35 

New QuickTfmeVR for 
Photographers Video! 

by Harry Liles 

Here’s the first video devoted entirety to the 
creation and usage of QuickTime VR. The 2 hr 
tape covers QTVR applications, equipment, 
techniques, business practices and much 
more. The tape is available in NTSC, SECAM 
and PAL formats. 




GoLive CyberStudio 2 
for Macintosh: Visual 
QuickStart Guide 

by Shelly Brisbin 

For Web designers who want to get the 
most out of CyberStudio’s WYSIWYG 
Interface and professional site 
management tools, there’s help. 
Peachpit’s Visual QuickStart Guide 
offers an easy, visual approach with 
step-by-step instructions and lots of screen shots. These guides are 
designed to provide the information you need in a concise, 
straightforward commentary, so you won’t have to wade through 
long-winded paragraphs and can get up and running in no time. 
There’s no better quick reference on the market. 

(BLIVE) Our Price $17 


avoiding problems with color palettes, using Net-specific Lingo, and 
using streaming Shockwave audio. Includes CD-ROM with dozens of 
actual movies by leading web developers. 

(BSHOCK) Our Price $35 



Shockwave Studio 

by Bob Schmitt 

This book shows how to create 
compelling and functional Shockwave 
movies for web sites by examining 
projects of leading multimedia 
developers and teaching — by 
example — many of their tricks for 
using Director. Covers techniques for 
reducing the byte size of movies, 




Java Distributed 
Computing 

By Jim Farley 

This book offers a general introduction 
to distributed computing, meaning 
programs that run on two or more 
systems. It focuses primarily on how to 
structure and write distributed 
applications and discusses issues like 
designing protocols, security, working 
with databases, and dealing with low bandwidth situations. 


JAVA 
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(VQTVR) Our Price $49 


(BDJAVA) Our Price $29 
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LINUX: Installation, 
Configuration, Use 


by Michael Kofler 

If you are looking for one book to teach 
you all the basics of Linux, from 
Installation and usage to simple 
programming, then this is the book for 
you, Linux: installation, Configuration and 
Use will get you up and running with 
Linux quickly and effectively, cutting out 


time-consuming instailation problems and searches for on-line 
documentation. Whether you are a Systems Administrator or a Linux 
novice, this book will provide you with a cohesive, authoritative 
introduction to Linux handling, 

(BLNXCON) Our Price $31 



A Practical Guide 


to Linux 

by Mark Sobell 

This new book by best-selling UNIX 
author Mark Sobell combines the 
strengths of a tutorial and those of a 
reference to give you the knowledge and 
skills to master Linux. Uniquely designed 
for both beginners and experienced 


users, A Practical Guide to Linux requires no prior programming 
experience, It begins with an extensive tutorial to bring those with 
less experience up to speed, and then quickly progresses to detailed 
chapters on GUIs, networking, the vi and emacs editors, three 
popular shells, programming tools, and system administration. 
(BGDLNX) Our Price $35 



Designing with 
JavaScript 

by Nick Heinie 

Written by the author of the "JavaScript 
Tip of the Week" web site, this Web 
Review Studio book focuses on the most 
useful and applicable scripts for making 
truly interactive, engaging web sites, 
You’ll not only have quick access to the 


scripts you need, you’ll finally understand why tie scripts work, how 
to alter the scripts to get the effects you want, and, ultimately, how 
to write your own groundbreaking scripts from scratch, 

(BDJAVA) Our Price $26 


Web site: http://www,devdepot.com 
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TCP/IP Addressing 

by Buck Graham 

A definitive, detailed, and relevant 
guide for network managers who have 
to implement TCP/IP networks, included 
are sections dealing with Classless 
Inter-Domain Routing (C)DR), 
Multicasting, and IP version 6. 

(BTCPAD) Our Price $26 


MacPerl 
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MacPerl: Power 
and Ease 


By Vicki Brown and Chris Nandor 

This new introductory and reference 
woi1< on MacPerl allows Macintosh 
users to gain access to fills powerful 
and versatile language. 

An introduction to programming, using 
MacPerl - No prior knowledge of 
computer programming Is assumed. 


Any competent and motivated Mac OS user should be able to learn 
(Mac)Perl from this product, Mac OS '’Power’’users should have no 
trouble at all. 

(BPERL) Our Price $36 



3-D Sound for Virtual 
Reallty/Multlmedia 

by Durand Begault 

This book provides a diverse group of 
research and development results that 
are appropriate to the developing 
technology of 3D sound as applied to 
virtual reality and multimedia. 

(BSOUND) Our Price $49 


Order blfiiree 
800-MACDEV-l 

180Oi22-33Sl| 
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MAGAZINE 


MacTech® Magazine 

MacTech keeps Mac programmers & developers up to date with everything they 
need to know about software development. Topics like Rhapsody, Java, 
QuickTime, OPENSTEP, Objective-C, C/C++, Object Oriented Technologies, 
product reviews and much more! 

Subscriptions: 

(MTYRDM) US/Oomestic for 12 issues $47 

(MTYRCM) Canadian for 12 Issues $59 

(MTYRFM) International for 12 issues $97 

Back Issues: each plus shipping (subject to availability) $10 




MacTech® CD-ROM Volumes 1-12 

• Includes Apple's Issues 1-29 (1990-1997) 

• Almost 1600 articles from all 139 issues of MacTech 
Magazine (1984-1996) and through may of 1997 

• Improved hypertext, improved Indices, and a new THINK Reference Viewer- 
for lightning quick access! 

• New hyperlinks between articles 

• 100+ MB of source code—use them in your applications, with no royalties! 

• Full version of TFIINK Reference™—the original online guide to Inside Macintosh, Vols. I-Vi 

• BOMB of FrameWorks/SFA archives and the most complete set of Frameworks archives know 

• Sprxket™! MacTech's tiny framework that compiles quickly and supports System 7.5 featurf 

• The best threads from the Macintosh programmer newsgroups plus thousands of notes, tips, 
snippets, and gotchas 

• Popular tools that Macintosh programmers use to increase their 
productivity and much morel 

(SMTCD12) Volumes 1-12 Our Price $129 
(SMTCD12U) Upgrade from any previous version Our Price $49 



INSID 






CINTOSH 


Inside Macintosh: CD-ROM 


by Apple Computer, Inc. 

More than 25 volumes in electronic form. Includes: 
QuickDraw™ GX Library, Macintosh Human Interface 
Guidelines, PowerPC System Software, Macintosh Toolbox 
Essentials and More Macintosh Toolbox, QuickTime and 
QuickTme Components. Access over 16,000 pages of 
information with Hypertext linking and extensive cross 
referencing. 

(BIMCD) Our Price $89 



Order Tell-lree 
800-NUCDEV-1 

ITO622-33811 
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Getting Started With WebObjects 

by Apple Enterprise Software 

If you're a first time user, start here to learn the basics of how to 
create and run WebObjects applications. 

(BGSWO) Our Price $14 

WebObjects Developer's Guide 

by Apple Enterprise Software 

A guide to building and understanding WebObjects applications. 
Takes a close look at the WebObjects scripting language. Additional 
sections explain the WebObjects architecture and tells you how to 
integrate your code into the request-response loop, create reusable 
components, create client-side components, take advantage of 
powerful Foundation Framework features, and more. Riled with 
example code. For ail WebObjects programmers. 

(BWODG) Our Price $16 

D'OLE Developer’s Guide 

by Apple Enterprise Software 

Distributed OLE is available today, and this book shows you how to 
use it. Using real-worid examples, the book steps you through the 
process of making your OPENSTEP objects available on Windows 
through OLE. 

(BDOLEDG) Our Price $22 

Discovering OPENSTEP, Mach 

by Apple Enterprise Software 

Introduces programmers to NeKTs OPENSTEP 4.0 Developer product 
by guiding them through the creation of three applications of 
increasing complexity. The tutorials demonstrate and explain 
programming techniques, Objective-C fundamentals, common APIs, 
and usage of the developement tools. Along the way they present 
summaries of important concepts and paradigms. The book also 
includes a chapter directing readers to programming resources, 
further infonnation, and services such as training and support. An 
appendix offers a concise discussion of object-oriented programming. 
(BDOSTEPM) Our Price $15 

Discovering OPENSTEP, Windows 

by Apple Enterprise Software 

Discovering OPENSTEP provides an introduction to OPENSTEP 
programming on Windows NT. It guides the reader through the 
creation of three applications of increasing complexity. Along the way, 
it explains concepts and illustrates aspects of Objective-C, OPENSTEP 
classes, the development environment, and programming techniques. 
A short appendix offers a summary of object-oriented programming. 
(BDOSTEPW) Our Price $16 



Object-Oriented 
Programming and Objective C 

by Apple Enterprise Software. 

An introduction to the principles of object-oriented programming in 
OPENSTEP and the official descripb'on of the Objective-C language. 
Objective-C is easy to learn and use because it adds very little 
syntax to the C programming language. It's dynamic nature allows 
you to accomplish things not possible in most other object-onented 
languages. For any OPENSTEP programmer. 

(BOOPOC) Our Price $24 

Working w/ interface Buiider (for eof) 

by Apple Enterprise Software 

A hands-on, award-winning book designed to help you get your Job 
done with the updated interface Builder, released with NEXTSTEP 
3.3 and the Enterprise Objects Framework 1.1. For any programmer 
using Interface Builder to design objects that truly work in 
NEXTSTEP. 

(BWIB) Our Price $24 

Using EOF 2.1 w/ OPENSTEP (Mach & Windows) 

by Apple Enterprise Software 

Using Enterprise Objects Framework with OPENSTEP describes how 
to create an Enterprise Objects Framework application on 
OPENSTEP. It includes a tutorial and a chapter on creating a user 
interface for an OPENSTEP Enterprise Objects Framework application. 
(BUEOFO) Our Price $14 

EOF Deveioper's Guide for EOF 2.1 (Mach & windows) 

by Apple Enterprise Software 

The Enterprise Objects Framework Developer's Guide describes how 
to develop database applications using the Enterprise Objects 
Framework tools and classes. It includes an architectural overview of 
the product, and descriptions of programming tips and techniques. 
An appendix offers a summary of Entity-Relationship Modeling. 
(BEOFDG) Our Price $24 

EOF Developer's Guide for EOF 2.0 {BE0FDG20) Our Price $24 
EOF Developer's Guide for EOF 1 .x (BEOFDGIX) Our Price $24 
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Rhapsody 
Developer's Guide 

by Jesse Feiter 

Covers the basic architectural principles 
ot Rhapsody: the Mach microkernel, 
object-oriented programming, and the 
elements of a modern OS such as 
preemptive multitasking, protected 
memory, and symmetric multiprocessing. 
Also shows ways of getting to this new environment— Objective C, 
conversion tools, and the integration of Java — to develop Rhapsody 
products. Paperback, 450 pages, 

(BRDG) Our Price $35 


Be Developer’s Guide 

by The Be Developement Team 

The Be Developer’s Guide is the otficial 
programmer’s reterence manual for the 
BeOS, a revolutionary new operating system 
built around multimedia, threading, and 
multiprocessing. Essential reading for anyone 
who wants to design runnable applications 
for the BeOS, this book describes and explains how to use all the 
development kits, providing multimedia developers access to ttie 
internals of the first new operating system in years. 

(BBEDEV) Our Price $45 



Interface Design: 

By Peter Bickford 

This book is a practical guide for designing 
software with users in mind. It offers an on- 
the-job view of what it takes to create great 
products, offering practical tips and advice 
instead of forcing the reader to extrapolate 
from abstract psychological theory. Interface 
Design targets a wide range of design issues, from taming the 
incomprehensible Interfaces of database systems and the Internet, 
to using sound and animation effectively in multimedia. Throughout 
the book, the author offers techniques for controlling the growing 
complexity of computer software, and makes an impassioned case 
for intelligent design based on the real need of users. 

(BINTER) Our Price $31 


The Java FAQ 

by Jonni Kanerva 

Java FAQ provides an insider’s view of the 
Java^'^ technology by posing 
and answering the most important, frequently 
asked questions about the Java 
programming language, Java applets, and 
Java stand-alone applications. The Java FAQ 
is unique in that it draws Irom the tens of thousands of questions sent 
to <java@java.sun.com> and provides authoritative answers direct 
from the creators of the Java programming language at JavaSoft. 
(BJFAQ) Our Price $25 




Interfede 

DeiSign 


Check out our Web site! 

• Full product descriptions • Hundreds of more products 

http://www.devdepot.com 


The OpenGL 
Programming Guide 

by Mason Woo, Jackie Neider 
and Tom Davis 

• Coverage of the new features of OpenGL, 
Version 1.1, including all texturing changes, 
vertex arrays, polygon offset, and RGBA 
logical operations 

• The incorporation of the OpenGL Utility Toolkit, GLUT, in all 
programming examples an overview of the OpenGL rendering 
pipeline and state machine 

• Enhanced coverage of polygon tessellation, quadric surfaces, pixel 
operations, and error handling 

• More performance tips 

• A greatly expanded index 
(BOPGL) Our Price $39 


AppleShare IP: 

By Tom Del! 

This book is for administrators either using or 
planning to use Apple’s new networking 
system. The book discusses choosing 
servers, configuration, access privileges, the 
AppleShare file server, print service, e-maill, 
web services, Apple Search, MacDNS and 
interfacing third party products, 

• Discusses choosing a server and the AppleShare file service 

• Cover AppleShare IP support for PCs 

• Addresses AppleShare IP e-mail, web and print services 

• includes hands-on exercise and one CD-ROM for Macintosh with 
and AppleShare IP Administrator’s Toolkit 

(BSHARIP) Our Price $35 

Effective C++, 

Second Edition: 

50 Specific Ways to Improve Your 
Programs and Designs 
by Scott Meyers 

Effective C-i-+, 2nd Edition includes: Expert 
guidance on object-oriented design, class 
design, and the proper use of inheritance 

• An examination of the standard 0+4- library, including how the 
Standard Template Library and classes like string and vector affect 
the structure of well-written programs 

• Discussions of late-breaking language features like in-class 
constant initializations, namespaces, and member templates 

• Wisdom usually possessed by only the most experienced 
developers 

• Effective C-i-i- continues to be essential reading for every 
developer working with C-t-i-. 

(BEFFC) Our Price $34 
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DeBabelizer 

by Lise Despres and Paul Vachier 

DeBabelizer: The Authorized Edition is the 
ofticiai guide for Web designers, 
multimedia creators, artists and production 
specialists who want to take advantage of 
this powerful tool. 

Create graphics and images for the Web that download fast and 
look amazing 

Optimize graphics for CD-ROM, video, and animation 
Optimize and manage colors using the SuperPalettefTM) 

Discover DeBabelizer tips and advice from industry experts 
Master basic manipulation techniques, including rotation, scaling, 
cropping, and text overlay 

Explore key production techniques in all areas of graphics 
processing 

(BDEBTAE) Our Price $39 

Symantec Visual Cafe 
Sourcebook 

by Cary A. Jardin and Pam Dixon 

Symantec Visual Cafe, the first visual Java 
development tool that gives programmers a 
sophisticated set of tools. This book teaches 
programmers how to use Symantec Visual 
Cafe to create Java applets. It provides a thorough introduction to 
the language and gives advanced Java programmers information on 
how to use Visual Cafe to create their own Java development tools. 
(BSYMSOUR) Our Price $35 

Designing 3D 
Graphics 

by Josh White 

In this powerful book/CD-ROM package, 
top computer graphics artist Josh White 
tells you everything you need to know to 
create sophisticated real-time 3D 
graphics for computer games and virtual 
reality. This book contains the in-depth 
knowledge of software tools and hands-on modeling techniques that 
Josh White has learned while creating artwork for over 20 
commercial games, including Descent, Zone Raiders, Locus, 
Legoland, and ohiers. 

(BD3DG} Our Price $35 
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Teach Yourseif Java for 
Macintosh in 21 Days 

by Laura Lemay and Charles L. Perkins 
with Timothy Webster 

Add interactivity and multimedia to Web pages! 

A step-by-step guide to make your Website 
come alive. Learn the basics of programming 
Java applets and the concepts behind the Java language. Includes CD- 
ROM with a limited version of Roaster, the first commercial, integrated 
applet development environment for Java for the Macintosh! 
(BJAVAMAC) Our Price $36 
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Linux Configuration 
& Instailation, 
am Edition 

by Patrick Volkering, Kevin Reichard, and 
Eric F. Johnson 

Linux, the leading UNIX variant, has garnered 
loads of attention within the UNIX community. The 
amazing thing about Linux is that you don't need a workstation to run it. 
Linux Configuration & Installation, Second Edition lets you mn Linux 
today. Program with Linux using C, C-t-t-, Perl, and Tcl/Tk. The 2 CD- 
ROM pack offers one of the most popular Linux distiibutions, Slackware 
96, and comes directly from Patrick Volkering, the creator of Slackware. 
{BLCI2) Our Price $35 





JavaScript 
& Netscape Wizardry 

by Dan Shafer 

The perfect book to show you how to turn 
Netscape into your own personal, customized 
operating system. Provides the inside tips 
and techniques for making your Web pages 
much more attractive. Shows you how to use 
all of the key features of the JavaScript language, including objects, 
methods, properties, events, and much more. Includes CO-ROM with 
numerous interactive scripts written in JavaScript you can add to your 
Web pages today. A complete set of the best Java applets. Useful plug¬ 
ins designed to supercharge Netscape and resources to help JavaScript 
programmers. 

(BJNWIZ) Our Price $31 
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The Java Class LibrarieSi 
Second Edition, Volume 2 

by Chan Lee 

This book is intended as a reference rather 
than a tutorial. Its format is similar to a 
dictionary's in that it is designed to optimize 
the time it takes for you to look up 
information on a class or class member. The 
classes in this book are ordered alphabetically without regard to 
package name. This makes looking up a class as straightforward as 
looking up a word in a dictionary. Each class is described in ite own 
chapter. Each chapter contains a picture of the class hierarchy, a class 
description, a class example, a member summary, and descriptions for 
every member in the class. 

(BJCUSS) Our Price $44 

Increasing Hits and Selling 
More on your Web Site 

by Greg Helmstetter 

Written especially for entrepreneurs, 
corporate marketing manager, small 
business ovimers, and consultants, this 
valuable guide gives you rare tips and tricks 
you need to know to make your site a commercial success. 
(BIHSMWS) Our Price $ 22.45 
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Programmer’s Toolbox 
Assistant CD-ROM 

Instant electronic access to 
Inside Macintosh essentials, 
by Apple Computer 

Get quick access to reference pages for over 
4,000 Toolbox calls in your system software 
from their development environment. Essenfial 
information for Macintosh software developers. Hypertext links allow 
programmers to view reiated topics easily. The ultimate electronic 
reference tool for Macintosh programmers. 

(STBASST) Our Price $89 
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The Official BBEdit Book 

by Bob LeVitus and Natanya Pitts 

The Official BBEdit Book makes it easy for 
today’s Webmasters to speed their own 
interactive development projects using this 
powerful editing environment, Bare Bones 
incorporates features like floating palettes, 
HTML support, and syntax coloring to 


enhance an already extensive feature set, making BBEdit a leading 
Web authoring tool. Super-fast text processing, easy scripting, wide 
extensibility, strong GREP-style search-and-replace capabilities, and 
support tor 13 languages make it easy to see why so many Web 
developers use BBEdit as their primary authoring tool, 

(BOEBB) Our Price $35 
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HTML For The World 
Wide Web, 2nd Edition 

by Elizabeth Castro 

Teach yourself Hypertext Markup 
Language the quick and easy way! This 
Visual QuickStart Guide uses pictures 
rather than lengthy explanations. You'll 
be up and running in no time. If you 
need to learn HTML fast - this is book 
is for you, 

(BHTMLW2) Our Price $ 16.15 

Macromedia 
Shockwave for Director 

by Jason Yeaman and 
Victoria Dawson 

The complete resource for creating 
Shockwave movies on the Web. This 
hands-on reference makes it easy to 
create Shockwave movies and put 
them on the Web. Expert tips from the 
creators of Macromedia’s first 

Shockwave movies, together with detailed examples and Instruction, 
provide everything you need to get started. Includes CD-ROM, 
(BMSED) Our Price $27 



Getting Hits-The 
Definitive Guide To 
Promoting Your Website 

by Don Sellers 

Getting Hits explains in easy-to- 
understand language the underlying 
concepts behind the art ot Web site 
promotion, Just a few of the topics 
you'll learn include: using search 
engines with URL’s; finding related Internet groups or lists; 
understanding the nuances of click throughs and ad rates; and 
distributing press releases to key Internet contacts. With this book, 
you'll go beyond the conceptual and actually follow real-world tested 
promotional campaign strategies. Bring the world to your Web site! 
(BGHITS) Our Price $ 17.95 

Optimizing PowerPC Code: 
Programming the PowerPC 
in Assembly Language 

by Gary Kacmareik 

Take full advantage of the potential of the 
PowerPC by mastering the Assembly 
Language techniques. Learn to produce 
faster more robust software! 

(BOPTPPC) Our Price $35 
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JavaScript For The 
World Wide Web 

by Ted Gesing and 
Jeremy Schneider 

This book takes an easy, visual 
approach to teaching JavaScript, 
where pictures guide you through the 
software and show you what to do. 
Works like a reference book, you look 
up what you need and then get straight 


to work. No long winding passages, concise, straightforward 
commentary explains what you need to know. 

(BJWWW) Our Price $ 16.15 


WebMaster in a Nutshell, Deluxe Edition 


by O'Reilly & Associates, Inc. 

Cross-platform, completely portable, and lightning fast, 
the CD-ROM is an invaluable addition to the 
webmaster's toolbox. The CD-ROM contains the Web 
Developer's Library — the full text of the latest editions of five 
popular O'Reilly titles: "HTML: The Definitive Guide, 2nd Edition"; 
"JavaScript: The Definitive Guide, 2nd Edition"; "CGI Programming 
on the World Wide Web"; "Programming Peri, 2nd Edition"; and 
'WebMaster in a Nutshel!." The Deluxe Edition also includes a 
printed copy of "WebMaster in a Nutshell," the all-inclusive quick 
reference that belongs next to every webmaster's terminal. Includes 
CD-ROM & 356 page book. 



Requirements: The CD-ROM is readable on all platforms, but requires 
a web browser that supports HTML 3.2, Java, and JavaScript, 
(BWMNLfTD) Our Price $62 


26 1-800-MACDEV-1 • Outside U.S. & Canada: 805-494-9797 • Fax: 805-494-9798 





























CodeWariior Software 
Development Using PowerPlant 

by Jan L. Harrington 

C++ programmers will ieam to develop object-oriented software 
applications for the Mac and Power Mac using the PowerPlant 
environment and the classes that support it. Covers CodeWarrior 8 
Included CD-ROM contains source code for all the programming 
examples in the book and Metrowerks CodeWarrior Lite. 

(BCWSWDEV) Our Price $31 






JavaScript 1.1 
Developer’s Guide 

by Arman Danesh and Wes Tatters 

Written by developers for 
developers. An advanced 
guide to creating 
professional Web 
applications with 

JavaScript 1.1 as deployed in Netscape 
Navigator 3.0, Microsoft Internet Explorer 3.0, and LiveWire. Includes 
CD-ROM with Sun's Java Developer's Kit, JavaScript and HTML 
Editors for Windows and Macintosh, 20 contributed ready-to-run 
JavaScripts and JavaScript examples from the book. 

(BJSDG) Our Price $44 
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Debugging Macintosh 
Software 
with MacsBug 

by Konstantin Othmer and 
Jim Straus 




MacsBug, from Apple Computer, Inc., 
I is the leading debugging software 
HM sTs.Aus I, program for the Macintosh. This 

book/disk package is an all-in-one kit 
for using MacsBug. Chapter 1 introduces MacsBug and describes 
the contents of the rest of the book. Chapter 2 describes how to 
install MacsBug and enough low level details about the Macintosh 
so that you can use MacsBug. Includes MacsBug 6,2 on disk. 
(BDMSWM) Our Price $31 


Check out our Web site! 

• Full product descriptions • Hundreds of more products 

http://www.devdepot.com 




Learn C on The 
Macintosh, Second 
Edition 

by Dave Mark 

New revised edition! Easy-to-understand - 
everything you need to start programming. 
Updated and enhanced exercises that lead you 
step by step. You'll learn function, variables, point datatypes, data 
structures, file input and output and more! Includes CD-ROM with 
Metrowerks CodeWarrior'^’^ Lite. 

(BLEARNC2) Our Price $33 


The Way Computer 
Graphics Works 

by Oiln Lathrop 

A complete guide to mastering 
computer graphic basics. It Is written 
in a frank, down-to-earth style 
covering everything from how 
computer graphics are different from 
fine art and photographs, to modeling, 
pixels, and the principles of animation. 
All of this is done without resorting to mind-numbing equations and 
impenetrable technical jargon. 

(BWCGW) Our Price $ 29.65 
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Inside PowerPlant 

by Metrowerks 

Create PowerPlant applications using the CodeWarrior IDE and 
PowerPlant Constructor. Full descriptions of major PowerPlant classes 
and resources. Included are the PowerPlant Constructor Manual, 
including View, TextTraits and Custom Types editing, and PowerPlant 
Library Reference, covering all classes and functions in PowerPlant, 
(BINSPP) Our Price $34 
SEE RELATED CATEGORY: Dev, Environment 


C++ Programming 
with CodeWarrior 

by Jan L Harrington 

Beginning OOP for the Macintosh and Power 
Macintosh and Mac OS compatibles. Learn 
object-oriented programming techniques 
using C++ as the example language and 
Metrowerks and CodeWarrior as the example 
compiler. Enclosed CD contains example code from the book and a 
full-function Metrowerks CodeWarrior. 

(BCPPCW) Our Price $33 


Includes 

Disk! 


Wireless For 
The Newton 

by Julie McKeeban and Neil Rhodes 

A book that picks up where 
Programming for the Newton left off, 
teaching the reader how to develop 
Newton software on the Macintosh. The 
enclosed floppy disk provides a sample 
application, as well as a fully functional 
demonstration version of Newton Toolkit, 

• Learn to develop Newton software on the Macintosh 

• Hands-on Newton environment training with sample code 

• Includes disk with sample source code for a Newton application, 
as well as demonstration NTK - the complete development 
environment for the Newton 

(BWIRELESS) Our Price $31 
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A complete reference for anyone using AppleScript to modify existing scripts or to write 
new ones. Contains useful information for programmers who are working on scriptabte 
applications or complex scripts. Features detailed definitions of AppleScript terminology 
and syntax in the following categories: Value classes, commands, objects and 
references to objects, expressions, control statements, handlers, and script objects. 
Includes many sample scripts, discusses advanced topics such as writing command 
handlers for script applications, the scope of script variables and properties declared at 
different levels in a script, and inheritance and delegation among script objects. 


AppleScript Language Guide 

by Apple Computer, Inc. 


(BALG) Our Price $ 26.95 


SEE RELATED CATEGORY: Scripting 



AppleScript 
Applications: 

Building Applications with 
FaceSpan and AppleScript 


by John Schettino Affiliation & Liz O’Hara 


Build complete AppleScript applications using 
FaceSpan, a user interface development tool 
that makes AppleScript applications truly 
"Mac-Like”. Uses a step-by-step approach 
to demonstrate techniques for building 
applications through illustrations and 
samples. Provides Graphical User Interface 
(GUI) design tips and practical approaches for 
implementation, Contains one CD-Rom with 
AppleScript 1.1, a demonstrations version of 
FaceSpan 2,1, source code for all example 
applications numerous AppleScript shareware 
and demonstrations programs. Contains a 
section on debugging AppleScript 
applications using FaceSpan. 
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Special Edition 
Using CGI, 

2nd Edition 

by Jeffry Dwight, Michael Erwin 



and Robert Niles 


This complete reference provides 
professional Web developers and advanced 
personal users with the latest infonmation 

on using CGI (Common Gateway Interface) to interact with databases. 

• Explains client and server uses of CGI 

• Provides extensive coverage of live audio and video feeds, user 
chat and interaction, and CGI security 

• Features separate chapters devoted to language-specific tips, 
tricks, and traps 

• CO ROM is loaded with the HTML and CGI sample code from 
the book 

• Includes applications for guest books, mail and new gateways, 
browser identification, access restriction, and shopping carts 
(BSEUCGI) Our Price $44 


JavaScript for the Macintosh 






by Matt Shobe and Tim Ritchey 

Allows non-programmers to take 
advantage of the power of 
Netscape Navigator. Expand the 
capabilities of your Web page, without 
having to understand C or C+h-, CD-ROM 
contains “Wizlets" that allows you to easily 
create your own JavaScripts. Takes you step-by-step through 
programming cross-platform JavaScripts, Details how to create 
JavaScripts for JavaScript-aware Web browsers. 

(BJAVASCRPTJ) Our Price $40 


(BAPSCAP) Our Price $31 


Java in a Nutsheli, 2nd 
Edition 

by David Flanagan 

A detailed overview of all of the new features 
in Java 1.1. both on a package-by-package 
basis and in terms of overall functionality. A 
comprehensive tutorial on "inner classes" 
that explains how to use all of the new types 
of inner classes: static member classes, member classes, local 
classes, and anonymous classes, Practical, real-world example 
programs that demonstrate the new features in Java 1.1, including 
object serialization, the new AWT event handling model, 
internationalization, and a sample Java Bean, 

(BJNUT2) Our Price $ 17.95 

AppleScript Finder Guide, English Dialect 

by Apple Computer, Inc. 

Provides definitions for Finder object classes and comniands. Write, 
record, or run scripts that trigger the same desktop actions that you 
trigger using the keyboard and mouse. 

(BAFG) Our Price $ 17.95 

SEE RELATED CATEGORY: Scripting 

Inside CodeWarrior Professional 

by Metrowerks 

Includes CodeWarrior IDE User’s Guide. This is the printed version of the 
documentation provided on the CD. Covers CodeWarrior Professional 
Release, the debugger and associated tools. 

(BINSCWP) Our Price $34 

SEE RELATED CATEGORY: Dev. Environment 
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3D Graphics 
Programming ''.ro^ 
Using QuickDraw 3D 

by Apple Computer, Inc. 

Incorporate spectacular 3D graphics into 
your applications. Explore QuickDraw 3D, 
a revolutionary graphics extension to the 
Mac OS for Power Macintoshes, CD 
contains the complete QuickDraw 3D 
system itself and a complete database of the QuickDraw 3D API, 
allowing you instant access to the hundreds of graphics calls via a 
fast viewing engine. Book/CD-ROM, 640 pages. 

(B3DGRAP} Our Price $35 
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Advanced Color Imaging 
on the Mac OS 

by Apple Computer, Inc. * 

Enhance your software's color 
capabilities with step-by-step 
instructions. Augment the color support 
supplied with QuickDraw, and QuickDraw 
GX. Use the Pallette Manager to get the 
best colors on limited displays. Match 
colors between screens and input/output devices (scanners & 
printers). CD includes a complete reference informaflon in both 
QuickView and Acrobat formats. Plus, a sample application 
demonstrating ColorSync programming techniques. 

(BADVCI) Our Price $33 
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THcks of The 
Mac Game 
Programming Gurus 


MHIIIG 


by McComack, Ragnemalm, Celestin, et al. 

For beginning to expert game 
programmers. Compiete overview of all 
the necessary components of game 
programming on the Macintosh. Packed 
with valuable tools, utilities, sample code, CodeWarrior™ Lite and 
game demos. QuickDraw 3D and Power Mac optimization and inside 
info on how Glypha III was created. Hundreds of tried-and-true 
tricks, tips, and insider secrets from well-known Mac game 
programming experts. 

(BTRICKS) Our Price $45 




^ titiak Art of 

MACINTOSH 

GAME 

PROGRAMMING ^ 


DIack Art of Macintosh 
Game Programming 




by Kevin Tieskoetter 

Develop your own 3D games in 
C on the Mac. includes CD with 
project flies for both Symantec 
C and Code Warrior, Create 
freeform texture-mapped games and 
polygon graphics. Control dynamic source 
code—all compatible as native to the Power Mac. Write directly to 
the screen, bypassing QuickDraw. 

(BBUCK) Our Price $35 



Here are more products. For full product descriptions please see our 
Web site, or feel free to call, fax, or E-mail us. Our prices on books are at 
least 10% off list price. 
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Development Environments 
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PRICE 

PRODUCT 

CODE 

PRICE 

AppleScript. Applicaitana: Building AppUcalkitis w/FaceSpan 

.,.BAPSCAP. 

.$31.00 

TallgRTt’s RiJlflfl In DflRiQning Prngr^ims... 

..„BTAUGENT_,,. 

...17.55 

C++ ftrograrriniin^ ........ 

.BCPPMACAP... 

.31.00 

ftie Power of Prograpb CPX... . . 

..BDANPRQ.. 

.. 19.95 

C/C++ SDK Users Quids........ 

...... BCPPUSER .... 

... 29.00 

Visual Progranutiiig with Prograpti CPX...... 

..BVISPRO.. 

..30.00 

CodtW^rrior Irsidtr Po^rflapt....... 

..BINSPP... 

...34,00 

Wireless ForTfie Ntewton........ .. 

....BW1R0-ESS... 

.31.0Q 

Cylwnrlng PmgrammRrs Kit .,. .. 

.BCYBERDOG 

Mm 




Dan Shafer Presente the Power of Prograpti CPX... 

......BOWRO. 

....19,95 

Hardware 



Inside CodeWarritir Book.......... 


.34.00 

Appifl nVRHM Hnridhenk 

.0CDHAND... 

..14.39 

Jnstanl COFBA..... 

.. 

.bk .. 

...„ .17.99 

rinnigrting Cflirt; H Uriuflm fnr ttin Marjntnsb. ,,... 

....BCAJ^....... 

.. MM 

Last Resort Programmers EtStiofi....... 

_Flf JTTR53RT_ 

... .74.00 

L^rWrlfer Reference 

.BIASERREF_ 

..J7.99 

ManinftfLiin r FVnjmmmin^ Pflrtuir Unlumiii 1 . 

.... ..BCPRiMf. 

24.2S 

PQ Systam ArcJiitBctura 3riJ Edition....... 

...BPOSVS. 

.31.00 

Macintosh C Proparnmirkg Primer Valume II.............. 

..BCPRIM2. 

..24.25 

PowerPC Sysiein Archilecliire ... . .... 

..BPPCftRCH. 

..31.00 

Macintosh Pascal Praarammmg Primer Vtilume3... 

RPARPffli 

24.25 




MaElCring the TWnk Class Library....... 

__ BMASTOITCL,. 

..26.95 

Internet Related 



Masterfog the Tooltffix Using THffJK C ........ .... 


24.25 

inteiiiel White Pages................... 

_B94WeE„„. 

..26.95 

Dhiectlve-C - Object-Oriented Pyo^rammlng.. 

...BOSJCOOPT... 

..34.00 

Acfiive Ja'rfa......„...... ... 


. 23.36 

PrlfSflnlmrj Magic Ftap. .. 


..15.25 

America Online for DLimmlas.......... ... 

. 

.. 17,95 

RpjqJ IMnnrl Apfite Ri ibrifi . .,,, 

HHRUW^n 

...35.00 

CGI By Example..... 

. . 

...BCGI0E..... 

..31.00 

Svmaritfln 0+-i- Pnonramminfl... 

. nmiOPP . 

.,39.00 

Biiildlfifl & Maintainirw an Intrarei w/ Itw Madnloali....__ 

..BBAMAf. 

.45,00 
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.22j45 
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.........eOCGIA... 


E-Mail EsBerrtlate............ 

......BEMARf... 

. 

.22.46 

Elacrtents of E-Mail Style....... 

...Bam.. 

... 13.45 

Hooked on Java........ 

...BHLWVA,. 

.26.95 

Instant InEemet GlmtIe.............. 

...HIWSTAl^T ... 

13.46 

tnlsmet Soak,............... 

......BTHEMET... 

.22,59 

Intefnet tor Dummies 2nd EdItiQn ....... 
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..17.93 
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.-BOUMOCK. 

. 9.05 

Intemat for Macs for EJummlas...... 

.....BfiETOUM.... 

.17.95 

Iniemel Tor Macs for DummlK BeslsellEf Eribofi.... 

.BFMR5BE. 

.35.00 

InterrtBt Power IdOfe.......... 

.BPWR[r00L...„. 

.36.00 

Internet Pdbllanlnci wiiti Adobe Acrobat_____ 

.....BFWAA.... 

........36lOO 
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Java Essentials for C^++ Prognsmmsrs,....— 

Java in a Nutetidl........ 

Java Language API SupefaWe....... 

Java PrograrmTiing irrtttl GOftBA........ 

JaiuaScrlpE Codiook........... 

JavaScript for J^aGlrrtosfi......... 

Learn HTML on tha MadnltKh......... 


-BNETDELUtk.,.. 

..BSHTWC.. 

BJAVA£SSBf... 


.BJAVAWUT. 

.BIAS.. 

.BJPWC.,_ 

..BJSCB..... 

.aJAtfftSCBFT.,, 
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...44.00 
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,13*45 

S3.a0 
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.40.00 
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i.eain JHvg on me Niscmioan--- 

Mastering ffetscapa 2.0 tor Macrntosti, Second Ei^on.. 

.. .......... 

.BMASNET2.. 

..JI.UU 

.36,00 

M^surlng the irnpact of Ybur Web Site. 

.BMIYWS.. 

.26.95 

Mwa InJEmal fur DuFtimtes Starter IQt..... 

.BOUMMET. 

.17,95 

Mosaic Tor Dummies................................... 

..JMOSOUM............. 

....17.93 

Het Chat......___ 

..Bf^CHAT.. 

.17.00 

MetObfects Fusion Handbook......... 

.BNETOFH..., . 

.45,00 

Pfvl Quirli RpfprfRnw! , ... , ,., . 

.JPetLREF . 

.17.99 

Ptteining and Martaging Websites......... 

....BfnANWEB.. 

.35.00 


Proteci Your Privacy on Ihe Iniemel... 

pEWiltfing Internet Services via the NtacOS. 

PuBBsh IE on me Weti-.... 

TOP/lPVoll’Vd 2 Bundle... 

Teach VotiTseO Java m 21 ilays... 


.BPVP. 

.ePBOVNET. 

......eWEBPUB........ 

.„***JTCP12BN0L... 
.BJAVAMAC. ...*-*. 


26.39 

...31.00 

31.00 

99.00 

30.00 


Tha Internet Strategic Plan......... 

..BTlSP. 

... 22.45 

The Web ftavigator...... 

..BTWN..„. 

.22.4S 

UnpdEfpnund Guide to TetecamiiiLding..... 

. , .. BWCEH.. 

. .22.45 

Lfelflg Lotus Motes as an irMranet ... 

mBh 

40.00 

Wob Graphics Tisols and Tecimiques...... 

...BWGTT_ 

..36.00 

Wfib Heart Ua(! RisflPi ,,. 

.... BWEBHEAD 

22.45 

Web Mairkshrig Cochbook ....... 


.35.00 

Web Page Scripting Techniques ..... 

. 

...BWEBPST 

4.500 

Web Publishar'a Design Guitte tiS' Madnlosh, 2nd EdUfori. 

... 

..35,00 


Web Publistiing wrlh Adntta Acrotiat and PtJF_ 
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Web Wsaving _________ 


.22.45 

Wfibrna-SliRr Marirmnsh 

.. 

RUUFRMA.<; 
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Scripting and Solutions 

AppleScript Appilcatiosis: Building Apps witii Fac^parii. 

RMISDAP 

.31.00 

AppleScript Scrlptlhg .Addili^ ....... 

.BSOIADQ.... 

...17.05 

Applied Ntecintosh Sorlptlng ............____ ......... 

. .. RAPPtm. 

31.00 

Complete HyperCarrl 2.2 Handbook...... .. 

..BHYPCflD2... 

.31,00 

rjsnpipJifi Hypprlflilk 7 7: . 

RHVPPfin? 

31.00 

Darniy Goodman^ Gurde Starter Kit,... 

.BDGAGSK... 

31.00 

Hypurflanri SJarJt DfKign. .,. 

.BHYP^A. 

.19.95 

JavaScript for Macintosh,.,.,,,....... 

RIAVASDRPT 

...4000 
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.. BPERUlEf.. 

... 17.93 

Real Wbrtcl Anaie Guide__________ 
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Technical Reference 

Active J3V9 ..... 
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.23.36 
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... 14.36 
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..JAHIO,... 

..mm 

Black Art of Mac Game Programming . .......................... ................. 

...HflLAiCK... .. 

...36.00 

Butlding An Extranat: Connect Vdijr Intranet with Vendors and Customer.... 

..BBLDEXT.. 

.26.99 

C-M- Inr fliimmifts..„.,.,. 


22.46 

C tnr Dummies VW, 1 , . ■ , ■ 

.. 

.ttcniM. 

.17.95 

Oevdopir^ Objbct Oriented Software for ttte Macintosh.,,... 

..,BDEV0e. .... 
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Fsftflrwlln[} the Mar TenJhoK .,,,. 

FtFTlWT.,..,.., . 

..2Z4S 
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..BFOUMD. . 

,3SOO 
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..BFRA6.. ....... 

.35.00 

Gulfle In hAseirtrnRh ?^nftMiflre 1 rt^slbehnn . 

RlOrJUIT 

...24.26 

Guide to Macintosh System 7.5....... .. 

...BSYS7.5.. 

...22,50 


Insids the Maantash Communkatjons lootboK......... 

..BCOI^,... 

.,2246 

1 Rflfwiwwe . . , . . .. 

Rl flRFflRFF 

.17.96 

Laaim C++ on the Macintosh..... 

....BLRNCPP.„. 

.35,00 


Learn C on the Macintosh, Isf Edition... 

.BLEARNC1. 

. 31,00 

Lean C on the Macintosh, 2hd ETStioii... 

.JI-EARNC2.. 

_^..„J33jOQ 

Mac PrDQf ammiog for Dummies ............ ... 

..BMACDUM........ 

...17,35 
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...BCPRIM1.. 

...24wZ5 

Macintosh C ftograanmar Primer Voturra 2..... 
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..24,25 

Macintosh QLE2 Prog. Reference Woridrtg with Objects. 

..B0LE2..^.......... 

..40.00 

Macintosh Pasral Programming PtimHr Volume 1.... 

.BPASCPfll_ 

.. .24,25 

MadnEoah Programming Secrffts 2nd editkin.. . .. 

..BPSeCRET 

..28.76 

Macintosh Programmlns Techniques..*.. 

...BPTECK-,.... 

.31.00 

Microsoft Vtsuai J+-i-1.1 Sourcatjooh .... 

..BMVJS.. 

.35.00 

Mnffi Mnr Pmgrammlng Terhniqi®s... 

...JMDBETECH. 

.. .34.00 

Network Frontiefs BundlB........ 

.BNETFS.. 

......59,00 

Newton Programming &jlile...... .. 
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..40.00 

Object Oriented PirogramiTiirig Design 
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......29,60 

Powertooh; Digitai Momad's Guide ... . 

..BPBTENG. 

..2246 

PowerPC PnogrartimBr^ Tociklt........ 

.SPPCR. 

,,..40,00 

Practical Obfoct-Ohented Developmenl in C-h- and Java . 

.bpood .. 

.31.00 

Programming Inttoductkm 10 the Macintosh Family__ _ 

.JFAMLY.. 

...22.46 

Programming lor System 7....... 


..24.25 

Programming with AppleTalk.. .. 
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. ..22.45 
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.45,00 

World Apple Guide.. .. ... 

..BREAiWLD. 

.. . .36.00 
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. . . .BCSDDM _ 

... 17.95 

Cyberpunk Hanrtiook .... 

. BCVBPUNK., . 

. BM 

Danriy Goodman's Apple Guicfc Starter Kit ,, . . .. 

RDRARRk 

. ....31JM 

Ftanny Gnortfirari's ManifrtTKh Manrtonrik. „. 

..... BGOODHB . 

.. 26 j 95 

Frameworks Source Codte Disk .... .. 

..... MIFWSC . 

.. . 9.95 

FramaWofks Magaziine Baidt Issue....... .... 

.. MTFWBACK,..., 

... a.oo 

firAphir: Fiflms ? ....... 

. BGEMS2 . 

... 44.00 

Grafilc Gome 4 . .. 

. .. . . BGEMS4 . 

..44.00 

Graphic RRms/V ....... 

. BGEMS5 . 

. 44.00 

Inhnl-D Reveated .. _ .... .. 

ftH^FDRR/ 

. 40.00 

InslriF! nifR(!lnr B with 1 inga for Macmtnfih. „ . . 

..... K06WLM...... 

44.00 

Late Wight wtih Ma;lT{V?k , ^ ,, . ,, ,.,,, 

. ..tllATP... 

26.95 

Mac Baltiroom Readsr....... 

.. eeATH. 

.. 11.70 

Mflcrameifia DJrecttf Lingo Workshop 2nd EdIliDn 

. ... BMDLW2.. 

. , 40.00 

Mac Scfeamer The UiTimate Macintosh Suparcharging Kit .. 

„.....BSCREAM_ 

___31.00 

Uarjntnsii TriKh Cm trsa . ... 

..,.... BCRASH. 

.. „...26,95 

MacTech Back issues . 

. MTBACKtSS 

.. 10.00 

Marwnrtrl tittimate MadntfiKh Pmgfainmkng Rmk .,., 

.... BaTMAG.. 

.. 35,00 

MAnAmw '93 nn-RDM . . 

.... ,BMADA33 . 

. 9.95 

It^tlimedia Autfionng: Building and Devetoplng Doclm^,.. 

_ 

31.00 

M'dimfiriia fttfirter Kit f(>r UitelntrKh . . , , 

RMM.START 

. 27.00 

Pram from EjEsriencB........ 

... .0PRDF1T,™, 

__ 22.45 


Rs^cllE CoiTiplete, Second EcfttiDr . 
Sad Macs, Bamb^ and Disasters.... 


...0lffiSED2.... 

...BSADMAC... 


.31.00 


. ... 


SlandanlB For Online Communication.... 

Tile EtemeiMsof E-Mall Style.......0EMA1L.13.45 

The Software DavelDpar's & Marketer's Legal CompaniDn..^...BSOAMLC....33,00 

Tog on Software Design...........BTOG. 28.35 

Tridis d tie Mac Game Gums.......BTRtCKS...45.00 

and the Art of Resource Editing............BZAAORE.27.00 
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All entries in this index are alphabetized. For your convenience the product names 
are bold, book names are italicized and company names are in plain text. 


1000 Games for Macintosh..... 19 

3D Gmphics Pnjgrminisng Using OuiCkDrBw 3D... .....^ 

3-D Sound for Virtual IReaiity/Mtjitimer^a ........... 21 


AAA+ SoftwatB .............. . 6 

A Prac^ Guide to Unux.... ..........21 

Atisoft Cofpo^Btbn ..............3 

Abuse.........19 

Adamation...................9 

Additional Listings foe Development EnvhiNitneiits»««.^-- 

Addttional Listings for Gamas...—.......19 

Additional Listings for Internet..............13 

Additional Listings for Multimedia... ......18 

Additional Listings for Tools^ Libraries & Utilltias^.^.^—...11 

Adiania Inc..........................10 

Advanced Coiar imaging on the Mac OS ............,...=.-29 

Advanced FUemaker Pro 4.0 Devebper Guide.. ...... 20 

AG Author, Inc........................ .,3 

Atura Softwara. Ina.......».......5 

Appb Enterprise Software .................23 

AppieSenpt AppUcatbns: BukUng Apps w FaceSpan/Appt^cnpt. .....2S 

Appi^cripi Fmder Guide, Engdsh Dialect .......... 28 

AppieShare P. ............ „ .24 

AppleScript Language Guide ............ 28 

AppMaker..............9 

Audi oTVack......18 


Bare Bones Software.................S, 10J2 

BBEdit 4.5...............8,12 

Be Developer's Guide,.,......,..., .......... 24 

Be. Inc,.......................3 

Beale Street Group, Inc.......,1S 

BeOs Preview Release 2________—......3 

BexhWare. Inc.............6,18.19 

BeatWarie......................11 

BeSpecific 3... 

Back Art of Macintosh Game Progmmfrmg,.,.. ..... ......................29 

Blusworld ComfTunicaliofis.......................,...12 

Bowers Development.......................... .9 

Bungie Software.*.............19 


CrH- Prpgrammjhg with CodeWarrIor ,...—.......... 27 

Captivate 4.6 Essential Graphics Utilities.......18 

Celestin Gompany..............11 

CGI Toolkit............13 

Classic Aficade......... 19 

Clip VR™..................18 

OodeBuilder............5, B 

CodeWanlor Discover Programming Editio......,,.3 

CodeWarrior for BeOS 3...............2 

CodeWarriorfor PaImPilot Release 4.......—..2 

CodeWanior Latitude .......2 

CodeWanior Professional Release 2......»..... 

CodsVl^ambr Software Deirefcpreent Using PawerPiant .......... 27 

Gonix Graphics.....................8 

CyberStudIo............12.15 


O'OLE Dev^etoperSs Guide . ..............23 

DaB^^eiizar. ............ ............. 25 

Debugging Macintosh Software with MacsBug .............24 

Designing with JavaScript ............. .21 

Designing 3D Graphics.... ...........,„26 


Digital Technotogv Intanational.......... „;14 

Digitool, Inc. ...................3 

Discovering OPENSJER Mach. ......... ...23 

i^scQvenng ORBVSTBR Windows..... .........23 

E>y naMorph 1 J5... ..14 




Efbotive C++. Second Bdffcbo.............24 

EOFDevefoper's Guide for EOF2 . ?|?Wach & Windows) . ...............23 

EtherPeok™ for the Macintosh___—.....6 

ExposurePm.......... 15 


FaceSpan v3.0.............14 

Future Basle ll.„---------10 


GenieWorks, LLC..............7 

Getting Hits-Jhe De^tive Guide To Promoting Your l/l/eOsfte............23 

Getting Started With WebObiects. ...........„. 23 

GoUve .................... 12,15 

GoUve CyberStudio 2 for Macintosh: V7sua/ QuickStari Guide.,..,. ...... 20 

Guide Composer'^*^ 1.2..........»8 


—H— 


HTML For The World Wide Web. 2nd Emm. ..........26 

HTML Sourcebook. 3fd Ration ..........25 

HyperGuide 1.0..........12,18 


increasing Hits and SeiUng More on your Web Site.... .... ,...25 

intertace Design .... ...................24 

inside CodelA^rrior Profession^. ...................... 28 

inside Macintosh: CD-FtOM. .......... 22 

inside Pow^ant ............. 27 




Java Distributed Con:}puting ............. 20 

Java in a Nutsheti. 2nd Edi^ ........... .,..28 

JavaSenpt 1,1 Devetopesris Guide......... .............27 

JavaScfpt far the Macintosh ............ ,,....28 

JavaScfpf & Pietscape W^ardry...... .......25 

JavaSenjof For The World Wide lAfefj...... 26 

Joy Explorer...........6 


-K— 


Kaidan....................... .16-17 

KiW.-........^....17 

KIWI and KlWi+ Accessories......17 

KiWi+ Detent Discs....17 

KiWi Flash Hotshoe Level....17 

KiWi Landscape Bracket.....—...IT 

KiWi QuickTilt Leveler.........17 

KiWi-to^KiWi+ Upgrade..*.......17 


Lakewood Software...............10.18 

Lasso 2.6 ......12 

Late Night Software Ltd ..........,..14 

Leam C on TTie Macintosh Second Edition... ..........27 

Unux Con^ratbn & InsMatbn, 3rd Edition .........25 

UNUX: instaHation Configuiatbn, Use ..........21 


-M- 


MacA8D6,0.....T 

Macintosti Common Usp 4......3 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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Macromeda ^Ktckwam for Director ................ ..26 

MacPeri: Power and ............ 27 

MacJacmCCPROMVQkjmes ?-t2 ........22 

MacTecWE) Magana ...........—...22 

Magellan Accessories__________.16 

Magellan QC ......16 

Magellan QC Detent Wheels—.........16 

Magellan QC Pedestal Set_ _ ____16 

Magreeable Softw^.... ..... .... .. _________8 

Main Event Scftwans............................ 14 

Mainstay................4,13 

Mango Tree Software...........14 

Maxum Dev^opment.................13 

Media Cleaner Pro —--------18 

Metrowerks......................2.3 

MkLinuxr Microkernel Linux for the Power Macintosiu.....^^-^^^^^.............4 

Morph...14 

MuKiWare Multimedia Collection..................18 

Music TVacks .............18 

MW Visual SourceSafe Release 5.....2 

Myth The Fallen Lords ...........19 


Neon Software..................... 11 

I NelMetar ____ , ■ I I 

I New OuickTsme W for Photographers Vfcfeo ..—..........2C 

NewtCard___15 

Music Tracks_______________ ._ . 13 

NetMinder Ethernet....11 

NS BASIC CorporatiOfL...........5,15 

NS BASIC 3,6 for the Newton...... 


O:^-0ner]ted Progranmn^ C........................23 

ObjectMaster Professional Edition......S 

OhjectSet Mail SDK...........8, 12 

Onyx Techndogy. Inc. ....... .....................10 

OpenGL for the Macintosh .. 

Optinmng PowerPC Code: Prograrnming the PofwerPC Assembly Language.............26 


Rumpus. 


Script Debugger . ......14 

Scripter 2.0.........14 

SOf^flhgf L^guages: Airtoma^ the Web........... 20 

Seapine Software. Inc...................9 

ShodwaveStixfio....... ............ ....20 

Skyline™/SatelKte ..... 

SmalTTalkAgents for Macintosh _...___..._.5 

Smartcode Software...................8,12 

SoftPoiish CD-ROM..........^™.10 

Soptiisticated CmM ............... ........7 

Snap fmovation............7 

Spaas/ Edrtion Using OG/...............................28 

Spo^ghL____ __ 1D 

Staz Software ...... .......... 10 

StepUp Scftware................ ..fl 

StoneTable 68K/PPC___________ ,7 

StonsTablet Publishing..............7 

SuperPlotPRO...10 

SuperSoft ................ 10 

.A 

Symantec Vtsoai Cafe Sourcebook .......25 


.............. 21 

TCP/IP Scripting Addition________............._14 

reach for4toirifOShirr2f OayS.,...,-......... 25 

Techworks....................19 

Tenon Intersysiems,.,....^--—........,..5,8.13 

Terran Interactive...................18 

TestTrack'Bug Tracking the Macintosh 

The Java Class iJPrarfes; Second BMon, Volume 2 ...........25 

The Java FAQ ............. .24 

The Offibat BBPdit Book .............. ..26 

The QoenGi Programming GuKifo........... .24 

The QuickTtme VF? Book... ............ ...20 

The way Computer G'^ics rtforfts.--......... ..... 27 

Tools Plus libraries 4- 

Tricks of The Mac Game fliografTm^ Gums......„29 





PageCharmer 1.0.-r-..r---.i-----.13 

Panimatibn...........-------- 15 

Pictorius Inc..................13 

Pilot Attach^ Disk 1.........9 

Power MaohTen 4 n .3---------------.in 

PowerSD...................19 

PowerKey Pro Model 200, 600. 

Pracidal Qt^ect^Ordntod Devdopm&it in C++ and java............................. 

PreFab Player....... 14 

Prefab Software, Irrc.....„14 

PrimeBase RDBMS 

Rnima Tima Freeware.............................4 

Pro Fortian .. 

Programmer's fbofoox Assistant CD-flOW.... ..26 


QC____________..„.7 

Ooasar Knowledge Systems^ Inc . ...................................................................................5 

QuickPan Counterweighting 

QuickPan Detent Wheel. m- . 

QuickPan Magnum. ................ ...... ..16 

QuickPan Magnum Accessories........ . ..16 

QuickPan QuickTlIt Leveler...................................................16 

QuickTtme VFt Authoring Studio, Kaklan Bundle........... .16 


—R— 


PhapSOdy Developer's Guide ................... 24 

Royal Software, Inc.............. 14 



UNI SOFTWARE PLUS...................10 

Using EOF2.t w/OPENSJEP{Mach & Windows}........................^ .....23 


UNI SOFTWARE PLUS......... 10 

Using EOF 2.t w/OPENSJEP {Mach & Windows}........................^ .....23 

VIP-BASIC; Visual Interactive Programming in BASIC...... 

VTP^: Visual Intefactive Programming in C..._ 

Visual Cafe for Java Professfonal Dev^opment Edfen .............4 

Visual Cafe for Java Database Development Edition,.........4 

Visual MaoStandardBasic 3.0..................7 

VOODOO 1.8.............10 


—W— 


Waterb Edge Software...........*...............9 

Wi^Master in a Nutshe^, D^uxe Editkyn ..... ........26 

tVfePGtificfs Devefcper's Guide.... ................. ...... .23 

WebTen..........12 

Widgetizer.__________ 15 

............... 14 

l/Wiefess For The N&wton ..... ...27 

Working w/ interface BuSder jfor EDO ..*.... .23 


XplainCorporation .——,. ,,^,,____ . .. _^.-.21,27 
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ZCurve Software.... ........................ ....7 
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With Diamonds 
This Perfect, 
The Only Thing 
We Cut 

Are The Prices. 


Mitsubishi's full line of a ward-winning DIAMONDTRON^^ aperture grille 
monitors have a proven reputation for quality, reliability, and value. And now 
you can get all this at prices lower than ever before. 

Plus, you'll have added confidence knowing that all Qj 
Mitsubishi Diamond Plus® and Diamond Pro® Series 
monitors are backed by a full 3-year warranty, combined with 
service and support programs that are already the best in the business. With 
the new lower pricing, everyone can experience the DIAMONDTRON™ 
difference. Get all the details by contacting Mitsubishi Electronics today* 
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USA: 1-800-843-2515 • Canada: 1-800-387-9630* Qwikfax: 1-800-937-2094 

World Wide Webr www.mitsubLshi-display.com 


Diamond Plus® Series 

DIAMONDTRON displays for people who mean business 



A MITSUBISHI 

DISPLAY PRODUCTS 


Innovation On Display, 


CSSfionly $1493 
Diamond Plus lOOe 

■21719.7‘ DVI* 

• -1600 x 1200/85 Hz 

■30-108 kHz 
auto-scan range 
•USB-ready 


10 Only $599 
Diamond Plus 70 

•17716.0" OVI* 
■1280x 1024/65 Hz 
■30-70 kHz 
auto-scan range 


Reduced to $679 
Diamond Pro 87TXM 

■17716,0" OVI* 
■1600 x 1200/66 Hz 
■30-86 kHz 
auto-scan range 


Diamond Pro*^ Series 

DIAMONDTRON solutions for graphics professionals 

10iOnly$1799 Reduced to $1399 Reduced to $849 

Diamond Pro 1000 Diamond Pro 91TXM Diamond Pro 700 

•21719.7" DVI* -21719.7" DVI' *17'716.0" DVI * 

■ 1800 X 1440/76 Hz • 1600 x 1200/75 Hz • 1600 x 1200/75 Hz 

■30-115 kHz -30-95 kHz -SO-gSkHz 

auto-scan range auto-scan range auto-scan range 


01998 Mrcsubdetil Elccmniu Ani£rlcai Inc- ['EAMOMDTTRDN u a mdemadr of Miiauhlahi ELchcalc CcKponibn. Diaouikd Pm aiul DlaraznJ Plu are rc^LfSHcd 
tnutemarlH cif MltMiHulii ElpcttdnKH AmcricH, lilt. MiciTiKilf, Windcx««5 and the Wlndtiw* logo art tii«fcrtarlts of MkJiwfjft Corpotaricin. Mac WnJ the MftC 

OS Hie tr^cmnrlka of Apple CoiiipLiiei< Inc. Monbrnc prices and specthcarinnA subject co chan;gie without nocice. *DVI (Diogoital Viewable Erna^^) 
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IT'S BIGGER, TOUGHER, PASTE 


CodeWarrior Professional Release 2. just out and 

■* ^ 

•re-ady for some seriousn industrial-strength programming - Thi 
is the only Integrated Development Environment that allows 
you, to edit-i compile and debug Ci C** Java and Pascal program 
for multiple target processors and operating systems- Ue're 
still the codewriter'•s best friend and now we're better thar 
ever- Here's why; 

Xportable. project files — may be used interchangeably 
between flAC and Windows platforms 

X'vfile compare and merge — select two files to graphically 
view differences and merge changes 

X browse across subprojects — source code^browser works 
'f. across targets and subprojects 

You can count on CodeWarrior Professional -Rele-ase E- Ule*re 
powerfulT prov en t easy-to-Randle and we've had all our shots- 


CodeWarrior 


® WWW - me trouierks - CO 









